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ABOUT THIS MANUAL 



This manual is your guide to using the 8540 Integration Unit and its operating system, OS/40. 

This manual is not about programming techniques, specific microprocessors, or specific 
applications. Instead, it presents the information that will enable you to use the 8540 for your 
own tasks in hardware-software integration. 

In this manual, you'll find detailed information on all standard 8540 features, including 
emulation and intersystem communication. This manual also provides introductory information 
on several hardware products you can use with your 8540. Those products are described in 
detail in other user manuals. 

For new users, a Learning Guide introduces you to the 8540 and its system options, and includes 
sample demonstration runs. There's also an Index to help you find your way around the manual, 
and a Glossary that describes new terminology and terms that are used in a new way. 

For users of DOS/50 (the operating system of the TEKTRONIX 8550 Microcomputer 
Development Lab), the Technical Notes section contains a list of differences between DOS/50 
and OS/40. 



(5) 



8540 System Users 



CONTENTS 

SECTION 1 LEARNING GUIDE Page 

Introduction 1-1 

Specification, Installation, Configuration, and Verification 1-1 

Overview of the 8540 System 1-2 

Getting Started 1-8 

Starting Up the 8540 1-8 

Turning Off the 8540 1-10 

How to Enter OS/40 Commands 1-10 

Establishing Communication with the Host 1-11 

More About OS/40 Commands 1-13 

8540/8560 Configurations 1-15 

Emulator Demonstration Run 1-17 

For Continued Learning 1 -40 

Overview of 8540 User Manuals 1-41 



SECTION 2 OPERATING PROCEDURES 

Communicating with an 8560 2-1 

Communicating with a Host Computer 2-3 

Communicating with an 8550 2-5 

Downloading from an 8002A 2-7 

Program Execution 2-8 

Program Debugging 2-10 

Debugging the Program in the Prototype 2-13 

Using the Trigger Trace Analyzer 2-14 

Memory Manipulation 2-19 

System I/O 2-20 



SECTION 3 COMMAND DICTIONARY 

Command Index 3-1 

Introduction 3-2 

Other System Commands 3-2 

Command Syntax 3-2 

Special Keys 3-6 

Command Memory Areas 3-7 

Commands 3-8 

SECTION 4 INTERSYSTEM COMMUNICATION 

Introduction 4-1 

Terminology 4-1 

8540/8560 TERM Interface 4-1 

COM Interface 4-2 

8540/8550 Interface 4-4 

8540/8002A Interface 4-6 

8540/General Host Interface 4-7 



III 



Contents— 8540 System Users 



Introduction 5-1 

The Emulator 5-1 

Emulation Modes ,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,...,.,... 5-1 

Selecting the Target Processor 5-3 

Basic Emulation Tasks 5-3 

Considerations for Modes 1 and 2 5-6 

Symbolic Debug 5-7 

The Memory Allocation Controller 5-9 

The Trigger Trace Analyzer 5-13 



SECTION 6 SERVICE CALLS 

Introduction 6-1 

Overview 6-1 

Limitations of File Handling SVCs 6-4 

I/O Channels 6-4 

SVC Applications 6-5 

SVC Demonstration 6-6 

SVC Functions 6-10 



SECTION 7 EMULATOR SPECIFICS 

SECTION 8 PROM PROGRAMMER SPECIFICS 

SECTION 9 TECHNICAL NOTES 

Note 1 . Practical Limits of Emulation 9-1 

Note 2. Comparison of OS/40 Version 1 with DOS/50 Version 2 9-1 

Note 3. Comparison of the TTA and the RTPA 9-2 

SECTION 10 ERROR MESSAGES 

SECTION 11 TABLES 

Conversion Tables 11-1 

Tektronix Hexadecimal Format 11-4 

Motorola Load Module Format 11-8 

Intel Load Module Format 11-10 

SECTION 12 GLOSSARY 
SECTION 13 INDEX 



IV 



8540 System Users 



Section 1 
LEARNING GUIDE 



Page 

Introduction 1-1 

Specification, installation. Configuration, and Verification 1-1 

Overview of the 8540 System 1-2 

Uses of the 8540 1-2 

8540 Parts and Functions 1-4 

The Host Computer 1-7 

Getting Started 1-8 

Starting Up the 8540 1-8 

Turning Off the 8540 1-10 

How to Enter 08/40 Commands 1-10 

Establishing Communication with the Host 1-11 

More about 08/40 Commands 1-13 

8540/8560 Configurations 1-15 

Emulator Demonstration Run 1-17 

Introduction 1-17 

Examine the Demonstration Program 1-19 

Assemble and Load the Demonstration Program 1 -22 

Case 1 : Assemble on the 8560; Download to the 8540 1-22 

Case 2: Download from Your Host to the 8540 1-28 

Case 3: Patch the Program into Memory 1 -30 

Run the Demonstration Program 1 -32 

Monitor Program Execution 1 -35 

Summary of Emulator Demonstration Run 1 -39 

For Continued Learning 1 -40 

Overview of 8540 User Manuals 1-41 



(a) 1-i 



8540 System Users 



IMDLt=d 

Table 

No. Page 

1 -1 Jack Assignments and Device Names for 8540 Peripherals 1-8 

1 -2 COM Interface Checklist 1-9 

1 -3 Basic 8560 Editing Commands 1-25 



ILLUSTRATIONS 

Fig. 

No. Page 

1 -1 Role of 8540 in product design ....__._...__..,.,,.,..,.,............ 1-3 

1 -2 8540 logical subsections 1-4 

1 -3 Demonstration program 1 -1 6 

1 -4 Demonstration program: Extended Tekhex format 1-18 

1 -5 Demonstration program flowchart 1-21 

1 -6 Host computer commands for preparing demonstration program 1 -28 



I -II 



8540 System Users 



Section 1 
LEARNING GUIDE 



INTRODUCTION 

This Learning Guidegivesanoverviewof the features and functions of the 8540 Integration Unit 
and its operating system, OS/40. It also presents a demonstration that gives you hands-on 
experience with the 8540. This Learning Guide is divided into the following topics: 

• Overview of the 8540 System. Explains the role of the 8540 in the development of 
microprocessor-based products and describes the parts of a complete 8540 system. 

• Getting Started. Provides instructions for starting up your 8540 and establishing 
communication with a host computer. 

• 8540/8560 Configurations. Explains three ways to connect an 8540, an 8560, and a 
system terminal. 

9 Emulator Demonstration Run. Shows you how to assemble, load, execute, and monitor a 
simple program. 

• For Continued Learning. Helps you decide where to go next in this manual to accomplish 
your own tasks. 

• Overview of 8540 User Manuals. Describes the types of user manuals that support your 
8540. 

NOTE 

Throughout this manual, the term "microprocessor" refers to both 
microprocessors and microcomputers. 



SPECIFICATION, INSTALLATION, CONFIGURATION, AND 
VERIFICATION 

For information on how to install and verify your 8540 hardware, and for product specifications, 
refer to your 8540 Installation Guide. 
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Uses of the 8540 

I hree principal stages in the ueveiopment of a microprocessor-based product are! 

1 . hardware development: design and construction of a hardware prototype of the product 

2. software developnient: design and creation of the program(s) that will execute in the 
microprocessor that controls the product 

3. hardware/software integration: monitoring the software as it executes in the prototype 
hardware, and modifying the software or hardware to correct problems. 

The 8540 Integration Unit is an important tool in stages 2 and 3, software development and 
hardware/software integration. 



Software Development. While your prototype hardware is under development, the 8540 can 
help you debug the programs that will execute in the prototype. After you have written your 
program and compiled or assembled it on a separate computer (referred to as the host 
computer), you can download the program to the 8540 to be executed. As your program 
executes in the 8540, an emulator (also called an emulator processor) performs the functions 
of the prototype microprocessor. You can use the memory and I/O facilities of the 8540 to 
simulate the signals your prototype microprocessor will have to deal with. 

Hardware/Software Integration. Once your prototype hardware is built, you can test its 
operation by temporarily replacing the prototype microprocessor with a prototype control 
probe from the emulator, Under this arrangement, the 8540 acts as the prototype's central 
processing unit, and you can monitor your program as it interacts with the prototype hardware, 
by doing so, you can discover errors that may remain in the software or hardware. 

Your 8540 can support a variety of microprocessors. To emulate a particular microprocessor, 
you select the appropriate emulator hardware and support software. This design concept allows 
you to use a single piece of equipment for the design support of many types of microprocessor- 
based products. 

Figure 1-1 shows a general procedure for using the 8540 Integration Unit to develop a 
microprocessor-based product. 
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Fig. 1-1. Role of 8540 in product design. 

You can use the 8540 to accomplish the tasks shown in the lower box. The host computer 
performs the tasks shown in the upper box. 
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Fig. 1-2. 8540 logical subsections. 

This functional diagram shows the parts of a complete 8540 system. Shaded areas indicate 
equipment that is not part of the minimum 8540 configuration. 



854G Parts and Functions 

Figure 1-2 shows the components of a complete 8540 system. 

Minimum 8540 System 

A minimum 8540 system consists of an 8540 Integration Unit and a system terminal. 
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8540 Integration Unit. The 8540 mainframe houses the following components of the 8540 
system: 

1 . OS/40, the ROM-based operating system of the 8540. OS/40 supervises all functions of 
the 8540, which include. 

a. general input and output 

b. program execution, monitoring, and debugging 

c. PROM programming 

d. communication with the host computer. 

2. Program memory resides in the 8540. Your 8540 may be configured with 32K, 64K, or 
128K of program memory. As you develop your software and integrate it with your 
hardware, you can use program memory as a substitute forthe memorythat will reside in 
your prototype hardware. 

3. Optional hardware devices (described later under the heading "System Options") are 
attached to or installed in the 8540 mainframe. 

System Terminal. The system terminal is a CRT or other RS-232-C-compatible I/O device 
through which you communicate with the 8540. Unless you specify otherwise, OS/40 accepts 
commands from the system terminal keyboard and displays output on the screen or printer of the 
system terminal. To specify the system terminal in an OS/40 command line, use the device 
name CONI (CONsole Input) or CONO (CONsole Output). 



System Options 

COM Interface Package. The COM Interface package enables you to establish communication 
with a host computer using the OS/40 COM command. This option consists of an RS-232-C- 
compatible communication cable and a ROM (containing the COM command software) that 
inserts into the 8540's System ROM board. The 8540 does not need this option in order to 
communicate with an 8560 Multi-User Software Development Unit. 

Emulator. An emulator consists of one to three circuit boards that reside in the 8540 
mainframe. The emulator generally contains a microprocessor of the same type as the one being 
emulated, and also contains control circuitry that allows you to start, stop, and monitor program 
execution, using OS/40 commands. Your 8540 can contain up to two single-board emulators or 
one multiple-board emulator at a time. 

Prototype Control Probe. The prototype control probe connects the prototype hardware to the 
emulator and contains additional control circuitry. 

Once your prototype and emulator are connected, you can begin transferring responsibility for 
timing, I/O, and memory functions from the 8540 to the prototype hardware. To indicate which 
of these functions are handled by the 8540 and which are handled bythe prototype, you use the 
OS/40 EM command to specify the emulation mode. Mode (system mode) uses only 8540 
facilities, and is the only mode you can use until your prototype is connected. Mode 1 (partial 
emulation mode) uses a mixture of 8540 and prototype facilities. Mode 2 (full emulation mode) 
uses all of the prototype's facilities. In all three modes you control program execution through 
the 8540. Refer to the Emulation section of this manual for a more detailed explanation of the 
three emulation modes. 



Cn 
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information, control execution of your program, signal external devices, and aid in performance 
analysis. The TTA consists of two circuit boards that reside in the 8540 mainframe and data 
acquisition hardware that is installed in the 8540 rear •^anel. If ^'ou are familiar with the 
TEKTRONIX Real-Time Prototype Analyzer (RTPA) and would like to begin using theTTA, see the 
Technical Notes section of this manual for a comparison of the two devices. For more detailed 
explanations of the TTA, refer to the Emulation section of this manual and to the TTA Users 
Manual, which is provided with your TTA hardware. 

Memory Allocation Controller (MAC) Option. The MAC option is a circuit board that resides in 
the 8540 mainframe. It is designed for use with emulators for the Z8001 , Z8002, 68000, and 
other microprocessors that can access memory outside the range of 8540 program memory. 
Using OS/40 commands that control the MAC option, you can map address blocks used by your 
program into program memory. For more information on the MAC option, refer to the Emulation 
section of this manual. 

PROM Programmer. The PROM Programmer consists of a circuit board that resides in the 8540 
mainframe and a separate assembly that inserts into the 8540 front panel. You may use the 
PROM Programmer to read data from a PROM into program or prototype memory, to burn a 
PROM with data from program or prototype memory, or to compare the PROM's contents with 
the contents of memory. 

Tektronix offers a separate characteristic module for each family of PROM chips supported. To 
use a particular family of PROMs, insert the appropriate characteristic module into the front 
panel assembly. Refer to the PROM Programmer Specifics section of this manual for general 
information about the 8540's PROM Programmer and for specific information about your 
characteristic module. 



WARNING 



Because of potential shock hazards, do not attempt to operate the PROM 
Programmer before reading the introductory information in the PROM 
Programmer Specifics section of this manual. 

Line Printer. The line printer is a hardcopy output device that attaches to jack J 1 03 on the 8540 
rear panel. You can route almost any display produced by OS/40 to the line printer by specifying 
LPT as the output device. 

Paper Tape Reader/Punch. You can attach a paper tape reader/punch to jack J103 on the 
8540 rear panel. The paper tape reader/punch may be used as an input device (device name 
PPTR) or as an output device (PPTP). 
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The Host Computer 

A program to be executed on the 8540 must be prepared on a separate computer, called the 
host. Programming facilities that are usually provided by the host include file management, text 
editing, compiling, assembling, and communication with the 8540. 

The Operating Procedures section of this manual describes several procedures for intersystem 
communication. The Intersystem Communication section of this manual treats the topic in 
greater detail. 



The 8560 as Host 

The TEKTRONIX 8560 Multi -User Software Development Unit is a time-sharing computer that is 
specially designed to serve as host to up to eight 8540s simultaneously. TNIX, the operating 
system of the 8560, is derived from Bell Laboratories' UNIX^"^ operating system. TNIX 
incorporates the many software development tools of UNIX™, plus additional features for 
handling tasks that are unique to the development of microprocessor-based software. With your 
8540 and 8560 operating together under an arrangement called TERM mode, you have access 
to OS/40 and TNIX at the same time. TERM mode is discussed in more detail later in this 
Learning Guide and in the 8560 System Users Manual. (UNIX is a registered trademark of Bell 
Laboratories, Incorporated, Murray Hill, New Jersey.) 



Other Hosts 

If your host computer is not an 8560, you will probably want to have the optional COM Interface 
package installed in your 8540. This option enables you to use the OS/40 COM command to set 
up communication between the 8540 and your host computer. The parameters of the COM 
command configure your 8540 so that it can use the same RS-232-C-compatible 
communication protocol as a terminal attached to your host. Once communication is 
established, special directives instruct the COM command to transfer data (such as your 
program) to or from the host. 

Your host computer must convert your program to Tektronix Hexadecimal Format (Tekhex) 
before the COM command can download your program to the 8540. An example of Tekhex is 
given in the Emulator Demonstration Run later in this Learning Guide. Tekhex and the COM 
command are described in detail in the Intersystem Communication section. 

NOTE 

In order for an OS/40 command (other than COM) or a user program on the 
8540 to access files on the host, the 8540 and the host must be operating in an 
8 560 -style TERM interface. In this manual, it is assumed that the 8560 is the 
only computer that can host such a TERM interface with the 8540. However, the 
host side of the 8540/8560 communication protocol may be implemented on 
computers other than the 8560; such computers could also host a TERM 
interface with the 8540. 
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GETTING STARTED 

This subsection provides the basic information you need in order to begin using your 8540, 
including how to turn the system on and off, how to enter commands, and how to establish 
communication with a host computer. 

It is assumed that your 8540 has been unpacked, installed, and checked out, and that your 
system terminal and other peripherals have been configured to communicate with the 8540. If 
any part of your system is not ready for use, refertoyour8540lnstallation Guide for instructions. 

Throughout this section, it is assumed that the system terminal you use to control the 8540 is 
connected (via a cable) to the 8540. The next subsection, "8540/8560 Configurations," 
discusses three different ways to connect an 8540, an 8560, and a system terminal. 



Starting Up the 8540 

Make Sure Your 8540 Is Plugged In 

To make sure that your system is properly plugged in, verify that each of the following steps has 
been performed: 

• Plug the system terminal into a power socket and connect it to the jack labeled TERMINAL 
on the 8540 rear panel. 

• Plug any other peripherals into power sockets and connect them to the 8540 rear panel. 
Table 1-1 gives a complete list of jack assignments. 

• If you want to operate your 8540 in TERM mode with an 8560, connect them with a line 
capable of supporting HSI (RS-422) protocol. Plug the female end of the line into the HSI 
jack on the 8540 rear panel, and plug the male end into an HSI I/O jack on the 8560 rear 
panel. (Check with your 8560 system engineer to verify that the HSi i/0 jack is configured 
for HSI protocol.) 

• If you want to operate your 8540 with a host other than the 8560, connect a terminal line 
from your host to one of the REMOTE jacks (J1 01 or J 1 02) on the 8540 rear panel. Use the 
space in Table 1 -2 to record the jack number and REMOTE port switch settings that are 
appropriate for your host. 

• Plug the 8540 into a standard wall socket. 



Table 1-1 
Jack Assignments and Device Names for 8540 Peripherals 



reripnerai Device 


Jack 


Device Names 


system terminal 


J104 


CONI (input), CONO (output) 


line printer 


J103 


LPT 


paper tape reader/punch 


J103 


PPTR (reader), PPTP (punch) 


external computer 


J101 


REMI (input), REMO (output) 


external computer 


J102 


REMI (input), REMO (output) 
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Table 1-2 
COM Interface Checklist' 



Item 


For your host, use: 


REMOTE jack number: J101 (DTE) or 
J102(DCE) 




MODE SELECT switch setting 




REMOTE BAUD switch setting 




COM command parameters to establish 
communication 




COM command parameters for downloads 




COM command parameters for uploads 




Log on to host computer 




Prepare program in Tekhex format. 




Download program to 8540. 




Upload program from 8540. 




Log off. 





Fill in the information that is appropriate for your host computer. This table is not applicable if your host is an 
8560. 



Start Up the 8540 and Its Peripherals 

If this is the first time the system is being turned on, refer to the detailed power-up and system 
verification procedure in the 8540 Installation Guide. 

Turn on the 8540, system terminal, and peripherals in anyorder. The power switch for the 8540 
is on the front panel. The 8540 performs an automatic self-test on power-up or restart. This test 
is described in the 8540 Installation Guide. 

Within a few seconds, the message 

8540 BOOT Vx.x 

should appear on your system terminal and the SELF TEST light on the 8540 front panel should 
go out. Mext, OS/40 checks its EEPROMs for a command string called STARTUP. OS/40 
automatically executes the commands in STARTUP whenever you power up or restart your 
system. The STARTUP string is discussed in more detail later in this section. 
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After the commands in the STARTUP string have been executed, you should see the message 

OS/40 Vx . X (xxxx-xx) xx/xx/xx Copyright (C) 1981 Tektronix, Inc. 

followed by the OS/40 prompt character (>). The numbers in parentheses (xxxx-xx) can be used 
by your Tektronix service representative to determine whether your system is up to date. 

If your system fails to respond as expected, check the following points: 

• If you get no response within five seconds of starting up the 8540, toggle the RESTART 
switch on the front panel. Startup should proceed normally. 

• The "Copyright" message is displayed only if your 8540 is in LOCAL mode. Your STARTUP 
string may contain a command that takes the 8540 out of LOCAL mode and establishes 
communication with your host computer. Press the RETURN key once or twice; your host 
computer may respond with a login prompt. 

If your 8540 and your host computer are not on speaking terms yet, you need to be sure that your 
8540 starts up in LOCAL mode. You can prevent execution of the STARTUP string by setting 
switch position 1 (DIP switch number S1 1 00) on the 8540's System Controller board to 1 (open). 
Refer to your 8540 Installation Guide for instructions on accessing this switch. 

If your system has startup problems that cannot be remedied by either of these solutions, refer to 
the verification procedures in your 8540 Installation Guide or contact your Tektronix service 
representative. 



Turning Off the 8540 

You may turn off the 8540 and its peripherals in any order. (But don't do it now; you're just 
getting started.) 

How to Enter OS/40 Commands 

This Learning Guide uses the following conventions in presenting information that is entered or 
displayed on the system terminal: 

• Prompt— The OS/40 prompt character > is shown at the beginning of each command line 
to remind you to wait for the prompt before entering the command. 

• Carriage return — In this Learning Guide, the symbol <CR> is shown at the end of each 
command line to remind you to end each command with a carriage return. On most 
keyboards, you enter a carriage return by pressing the RETURN key. 

• Underlined — Characters to be entered by you are underlined. Responses by OS/40 are not 
underlined. 

• Numbers — Addresses are in hexadecimal notation unless otherwise indicated. The suffix 
letters H (hexadecimal) and T (decimal) may be used for clarity when both hexadecimal and 
decimal numbers are used in the same discussion. For example, 10H - 16T. 

• CTRL-x — Several control characters have special meaning to OS/40. Each control 
character is entered by pressing the CTRL key and another key simultaneously. To suspend 
a display as it appears on the system terminal, for example, you enter CTRL-S by holding 
down the CTRL key and pressing the S key. To resume the display (CTRL-Q), hold down the 
CTRL key and press Q. To interrupt the command or program that OS/40 is executing, 
enter CTRL-C. 
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Correcting Mistakes in a Command Line 

If you notice a mistake in your command line before you enter a carriage return, you have two 
ways of correcting the line: delete the entire line and start again, or correct the characters one- 
by or^e. 

• To delete the entire lin.,, lype CTRL-U. You may then reenter the line. 

• To delete characters one-by-one, press the BACKSPACE or RUBOUT key. Either key will 
backspace the cursor and erase the deleted character. 



Command Example 

Let's assume that your 8540 is started up and waiting for you to enter a command. (You should 
see the ">" prompt on your system terminal.) Enter the following command to calculate the sum 
of the hexadecimal numbers 44 and 55: 

> calc 44+55 <CR> 
99H 

OS/40 responds with the answer in hexadecimal. Now let's try something more exciting. 



Establishing Communication with the Host 

The ">" prompt indicates that the 8540 is in LOCAL mode, acting as a stand-alone computer. 
The 8540 starts up in LOCAL mode and stays in that mode until it receives a "CONFIG TERM "or 
"COM" command that sets up communication with the host. Once you have downloaded a 
program from the host, you may return the 8540 to LOCAL mode to execute and debug your 
program. This discussion explains how to establish communication with an 8560 (TERM 
interface) or with some other host computer (COM interface), and how to return the 8540 to 
LOCAL mode. 



8560 TERM Interface 

The sequence of commands you enter to establish communication with the 8560 depends on 
how your 8540, 8560, and system terminal are configured. Thethree most likely configurations 
are discussed in the next subsection, "8540/8560 Configurations." For now, let's assume that 
your system terminal is connected to your 8540 and that the line that runs to the 8560 is plugged 
into the HSI jack on the 8540 (as described earlier under "Starting Up the 8540"). 

Enter the following command to establish communication with the 8560: 

> config term <CR> 

Now the 8540 is in TERM mode: every character you type is sent directly to the 8560. Press the 
RETURN key once or twice; the 8560 responds with its "login:" prompt. Type in your 8560 user 
name and password, as described in the Learning Guide of your 8560 System Users Manual. 
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Now you're logged in to TNIX, the operating system of the 8560. The TNIX prompt is "$". Try 
typing a TNIX command: 

$ date <CR> 

iiMi/\ icojjwiiuo vvmi II ic cuiiciu udit; diiu iimtJ. 

Try tvninn an O-S/40 command! 

$ calc 44+55 <CR> 
99H 

TNIX recognizes that CALC is an OS/40 command, so it sends the command back to the 8540 for 
processing by OS/40. OS/40 sends its response back to the 8560, and the 8560 passes the 
response to you. 

Notice that TNIX expects you to enter commands in lowercase. If you type "CALC 44+55", TNIX 
responds "CALC: not found." 

In the Emulator Demonstration Run later in this Learning Guide, you'll see some practical 
applications of the 8540/8560 TERM interface. For now, log out from the 8560 and return the 

oc:Af\ *„ I r\r^Ai i_. 

oi^Tw lu i_wv.^A-M_ riiuue. 

S conf ig local ; logout <CR> 

The CONFIG command tells the 8540 to stop sending commands to the 8560, and the LOGOUT 
command tells the 8560 to stop accepting commands. Notice that these two commands cannot 
be entered in a different order or on different lines if they are to have the desired effect. 



When your 8540 is in TERM mode, do not toggle the RESTART switch on the 8540 
front panel. If you need to interrupt system operation, type CTRL-C. 

If you restart the 8540 while it is in TERM mode, the 8540 and 8560 may not be able to 
resume communication if any OS/40 commands are still active on the 8560. If your 
system seems to hang after you restart the 8540, you or your 8560 superuser must kill 
the OS/40 commands from a different terminal. (Use the TNIX command "ps -ax" to 
list all active processes and use "kill —9" to kill those processes associated with your 
terminal.) 

COM Interface 

Table 1 -? (earlier in this section) has space for recording the parameters of the COM command 
you enter to establish communication with your host computer. Here are some general rules 
that may apply to your host: 

• The default COM parameters are satisfactory for some computers. Try entering the COM 
command without any parameters. 

• For most computers, the COM parameters E, L, and M are sufficient to specify your host's 
communication protocol. 

• The COM parameters P, T, C, F, and HS affect data transfer protocols, and can be ignored 
until you are ready to test your host computer's upload and download software. 
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• For more information on the COM command and how to configure your 8540 
communication hardware, refer tothe Intersystem Communication section of this manual. 

When you enter the COM command with the appropriate parameters, the 8540 responds "COM 
Vx.x." Now any characters you type are sent directly to the host. Try logging on to your host and 
entering a few commands. The host should respond just as it would if the terminal were 
attached directly to the host. 

Try entering an OS/40 command: 

calc 44+55 <CR> 

Unless your host has its own CALC command, you will probably receive an error message. When 
the COM command is executing on the 8540, OS/40 cannot accept other commands. 

The null character (ASCII code 00) has a special meaning to the COM command. On most 
terminals, the null character is entered as CTRL-@ (hold down the CTRL key and press the keys 
that produce the "@" character). When you enter the null character, COM intercepts the 
characters you type next and interprets them as a directive to transfer data, display status 
information, or terminate communication. 

For now, log out of your host, and then terminate communication by entering the null character 
and pressing the ESC key on your terminal: 

(Log out . ) 
(null ) (esc) 

The 8540 should be in LOCAL mode once again. 



More about OS/40 Commands 
Type-Ahead 

OS/40 has a feature called type-ahead that allows you to enter additional commands even 
before the current command has finished executing. When OS/40 finishes a command, it 
issues the > prompt and goes on to the next command entered, if any. If you are in the process of 
entering a command when the prompt appears, just keep typing; the prompt has no effect on the 
line being entered, other than to disrupt it visually. 

Command lines that have been entered but have not yet begun execution are stored in the type- 
ahead buffer. This buffer also holds the command line currently being typed and has a capacity 
of 128 characters, including carriage returns. To display the contents of the type-ahead buffer, 
enter CTRL-R. To delete all text in the type-ahead buffer, type CTRL-U or CTRL-C. 

For the sake of clarity in this manual, type-ahead will not be demonstrated; it will be assumed 
that you will wait for the > prompt before entering your next command. 



Multiple Commands 

You may enter more than one command on a line if you separate the commands with 
semicolons. Be sure that the command line does not exceed 80 characters. 
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Strings 

To save typing, you can assign names to frequently used strings of characters. For example, 
suppose the command line that establishes communication with your host computer is: 

> COM P=4F4B EOL=ODOA T=03 M=6 <CR> 

The line 

> HELLO^'COM P=4F4B EOL^ODOA T=02 M-6 " <CR> 

defines a string named HELLO. Once this string is defined, every time you enter the command 

> $HELLO <CR> 

the string 'COM P=4F4B EOL^ODOA T=02 M=6' is substituted, and the 8540 establishes 
communication with your host. (Noticethatthedollarsign is omitted when you define the string, 
but present when you use the string.) 

You can use the OS/40 PERMSTR command to save strings in the 8540's EEPROMs, so that 
they are available for future use. Strings that are not saved inEEPROM are lost when you restart 
the 8540 or turn it off. For example, to save the HELLO string, type 

> PERMSTR HELLO <CR> 

You can also use the PERMSTR command to delete or display strings from EEPROM. If a string 
already exists in EEPROM, you must delete the old version of the string before you can save a 
new version. 

If you have a sequence of commands to be executed every time you start up the 8540, store them 
in the STARTUP string. For example, if you want to select the Z80A emulator and establish 
communication with an 8560 every time you start up the 8540, type: 

> STARTUP- ^CONFIG TERM; SEL Z80 ' <CR> 

> PERMSTR -D STARTUP <CR> 

> PERMSTR STARTUP <CR> 

The first PERMSTR command deletes the old EEPROM version of STARTUP, if any. The second 
PERMSTR command saves the new version. 

If your STARTUP string contains a CONFIG TERM command, that command must be the first 
command in the string. 

The name of a string can be 1 to 8 letters or digits; the first character must be a letter. In a string 
name, a lowercase letter does not match the corresponding uppercase letter. 

TERM Mode Considerations. On the 8560, strings are defined and used according to the same 
general rules as described here for the 8540. When your 8540 is operating in TERM most with 
an 8560, a string definition (stringname=string) or string substitution (Sstringname) always 
refers to an 8560 string unless you explicitly specify that the string belongs to the 8540. To 
define an 8540 string, precede the string definition with the word "8540" (8540 
stringname^string). To use an 8540 string, precede the dollar sign with a backslash 
(\$stringname). 

For most TERM mode applications, it is easiest to use only 8560 strings. You may use 8560 
strings in 8540 commands. However, the 8560 does not recognize strings on the 8540, and the 
OS/40 PERMSTR command does not recognize 8560 strings. 
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Uppercase and Lowercase 

OS/40 commands can be entered in uppercase, lowercase, or a mixture of the two. Uppercase 
and lowercase letters are interchangeable except in the name of a string, an emulator (for 
example, Z80), or a standard 8540 device (CONI, CONO, LPT, PPTR, PPTP, REMI, and REMO 
must be capitalized). 

Command examples in this manual may be shown in either uppercase or lowercase. Except as 
noted, any parameter shown in lowercase can also be entered in uppercase. 

NOTE 

If your 8540 is operating in TERM mode with an 8560, all OS/40 command 
names must be entered in lowercase. 



8540/8560 CONFIGURATIONS 

This subsection describes the three common ways to connect an 8540, an 8560, and a system 
terminal, and explains how to establish communication between the 8540 and the 8560 in each 
configuration. 



A. Terminai-8540-HSI-8560 

In this configuration, the 8540 has its own system terminal, and so can operate in either LOCAL 
mode or TERM mode. 

Cable Connections. The terminal connects to the TERMINAL jack (J 104) on the 8540 rear 
panel. The 8540 and 8560 communicate via a line that runs from the HSI jack on the 8540 to the 
HSI I/O jack on the 8560. The HSI I/O jack must be configured for HSI (RS-422) protocol. 

Establishing Communication. Start up the 8540. Enter the OS/40 command config term to 
enter TERM mode. Log in to the 8560. 



B. Terminal-8540-RS232-8560 

You may use this configuration in place of configuration Aif your 8540 and 8560 are at separate 
sites and so must communicate via a modem. 

Cable Connections. The terminal connects to the TERMINAL jack (J104) on the 8540 rear 
panel. The 8540 and 8560 communicate via a link that runs from the DTE jack (J1 01 ) on the 
8540 (possibly through a modem) to an HSI I/O jack on the 8560. The HSI I/O jack must be 
configured for RS-232-C protocol. The MODE SELECT switch on the 8540 rear panel should be 
set to DTE1. 

Establishing Communication. Start up the 8540. Enter the OS/40 command 

> config term i =r t =7 <CR > 

to enter TERM mode. Log in to the 8560. 
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If you cannot establish communication, "our 8560 I/O "^ort mav be configured incorrect!". Lo*^ in 
to the 8560 on a different terminal and enter the following command: 

$ stty lU >/dev/ttyn <CR > 

where n is the number of the HSI i/0 jack to which the 8540 is attached. Then restart the 8540 
and try the config command again. 

C. Terminal-8560-HSI-8540 

In this configuration, the 8540 can be operated from any terminal that is attached to the 8560. 
Since the 8540 cannot operate in LOCAL mode in this configuration, its STARTUP string must 
contain a config term command. To establish this STARTUP string, perform the following steps: 

1 . Attach a terminal to the 8540 (as in configurations A and B) and start up the 8540 in 
LOCAL mode. 

2. Enter the following lines to create the STARTUP string and store it in EEPRO!VI> 

> STARTUP=^ config term' <CR> 

> PERMSTR -D STARTUP <CR> 

> PERMSTR STARTUP <CR> 



01 






;8086 


DEMONSTRATION RUN 


PROGRAM 




02 








SECTION 


DEMO 






03 








ORG 


lOOH 


START PROGRAM CODE AT ADDRESS 100 




04 


0100 


210005 START 


LXI 


H, TABLE 


SET TABLE POINTER 




05 


0103 


0605 




MVI 


B, TSIZE 


SET PASS COUNTER 




06 


0105 


AF 




XRA 


A 


CLEAR ACCUMULATOR 




07 


0106 


86 


LOOP 


ADD 


M 


ADD BYTE FROM TABLE 




08 


0107 


23 




INX 


H 


POINT TO NEXT BYTE 




09 


0108 


05 




DCR 


B 


DECREMENT PASS COUNTER 




10 


0109 


C20601 


JNZ 


LOOP 


LOOP IF NOT FIVE PASSES YET 




11 


OlOC 


D3F7 




OUT 


0F7H 


OTHERWISE CALL EXIT SVC 




12 


OlOE 


00 




NOP 




TO END PROGRAM EXECUTION 




13 






;SRB POINTER 








14 








ORG 


40H 


STORE SRB POINTER AT ADDRESS 40 




15 


0040 


0042 




BYTE 


00,42H 


POINT TO SRB FOR EXIT SVC 




16 






;SRB FOR EXIT 


SVC 






17 


0042 


lA 




BYTE 


lAH 


lAH = FUNCTION CODE FOR EXIT SVC 




18 






; TABLE OF NUMBERS TO BE 


ADDED 




19 






TSIZE 


EQU 


5 


TABLE SIZE = 5 




20 








ORG 


500H 


SET UP TABLE AT ADDRESS 500 




21 






TABLE 


BLOCK 


TSIZE 






22 








LIST 


DBG 






23 






-^ 


END 


START 


, 


^. 


i 


I 


1 


I 


' 


i 




source code 


comments 
















-object code 


















_ nf^fjfocc 


















-auaicSS 

-source code line number 




3939-5 











Fig. 1-3. Demonstration program. 
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Cable Connections. The terminal connects to an HSI I/O jack on the 8560. This HSI I/O jack 
must be configured for RS-232-C protocol. The 8540 and 8560 communicate via a line that runs 
from the HSI jack on the 8540 to another HSI I/O jack on the 8560. This HSI I/O jack must be 
configured for HSI {RS-422) protocol. 

Establishing Communication. Log in to the 8560. To indicate which 8540 you want to use, 
enter the line IU=n;export lU, where n is the number of the HSI I/O jack to which the 8540 is 
attached. Start up the 8540. The STARTUP string puts the 8540 into TERM mode automatically. 

EMULATOR DEMONSTRATION RUN 
Introduction 

This demonstration run shows you how to load, execute, and monitor a simple 8085A assembly 
language program on your 8540. If you have an emulator other than the 8085A, refer to the 
appropriate Emulator Specifics supplement in this manual for a demonstration that is parallel to 
this one. 

In order to perform this demonstration, your 8085A emulator board and emulator control 
software ROM must be installed in your 8540. 

Figure 1-3 shows the source and object code for the demonstration program. 



If you have an 8560, and your 8560 
has an 8080A/8085A assembler 
installed, you can create and assem- 
ble the program on the 8560 and 
then download it to the 8540. This 
demonstration shows how. 

If you have an 8540 that is connected 
to a host computer other than an 
8560, we can't give you a specific list 
of commands for creating and assem- 
bling the program on your host (since 
we don't know what host you're 
using). However, Fig. 1-4 gives the 
object code for the program in 
Extended Tekhex format. You can 
create the Tekhex file using your 
host's assembler or text editor, then 
download the file to the 8540 via the 
8540's optional COM interface. 

If neither of these cases applies to 
you, you can patch the program into 
memory using the P command. This 
demonstration shows how. 



Case 



Must have 8085A 
assembler 




Case 2: 




Case 3: 



8540 + other host 



any other configuration 



Once the program is loaded or patched into memory, you can execute the program on your 
emulator. 
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IA\ 



%2769231002100050605AF862305CE0601D3F700 

%0E62B24000421A 

%3A3494DEM0010350514L00P310615START310015TABLEo50025TSIZEi5 



%098153100 



(B) 



FIRST DATA BLOCK: object code for addresses 100-10E 



header 

tload address 



object code 



%2769231002100050605AF862305C20601D3F700 



SECOND DATA BLOCK: object code for addresses 40-42 



header 

I load object 

t address code 
IJL 

%0E62B24000421A 



SYMBOL BLOCK 

header section 

I section definition 
! name field 

♦ t t 



symbol definition fields 



1 



%3A3494DEM0010350514L00P310615START310015TABLE350025TSIZE16 



TERMINATION BLOCK 



header 

1 transfer 
address 

%098153100 



Fig. 1-4. Demonstration program: Extended Tekhex format. 

Figure 1-4A shows an Extended Tekhex load module that contains the object code and 
program symbols for the demonstration program. Figure 1-4B gives the meanings of the 
different fields in the message blocks. If you have a host computer other than an 8560, you 
can create this load module and download it to your 8540. 
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Examine the Demonstration Program 
Explanation of Demonstration Run Program Source Code 

The demonstration run program adds five numbers from a table stored in locations 500-504 in 
program memory and leaves the sum in the accumulator. You will place values inthe table later 
in this demonstration. 

The source file contains two kinds of statements: Tektronix assembler directives and 8085A 
assembly language instructions. (Text following a semicolon (;) in a source line is treated as a 
comment by Tektronix assemblers.) The 8085A assembly language instructions represent the 
operations performed by the program; these instructions are discussed under the heading "How 
the Demonstration Run Program Works," later in this subsection. The assembler directives 
provide additional information needed to create the correct object code. The following 
paragraphs outline the functions of the assembler directives. 

SECTION DEMO. Every program consists of one or more sections. This directive declares a 
program section called DEMO. All object code for the demonstration program will reside in this 
section. (When you get into more practical programming applications, you may divide your 
program into different sections to reduce memory consumption or to make it easier to organize 
your program into RAM and ROM areas. Your Assembler Users Manual discusses the concept of 
sections in detail.) 

ORG 100H. This directive tells the assembler where in memory to locate the object code for the 
next instruction. In this case, the object code for the 8085A instruction LXI H,TABLE will be 
stored at memory location 100. 

ORG 40H. This directive specifies that the information for the Exit service call is to be stored at 
address 40. A service call (SVC) is a request for OS/40 to perform a special service for an 
executing program. An Exit SVC ends program execution and returns control to the operating 
system. 

An SVC always has at least three parts: 

• an I/O instruction that initiates the SVC 

• a service request block (SRB) that contains the parameters of the SVC to be performed 

• an SRB pointer that tells where in memory the SRB is located. 

SVCs are explained in the Service Calls section of this manual. 

In this program, the instruction OUT 0F7H directs OS/40 to perform the SVC whose parameters 
are pointed to by the address in locations 40 and 41 . 

BYTE 00,42H. This directive specifies that the SRB pointer (the address of the SRB for the Exit 
SVC) is 0042. 
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BYTE 1 AH. This SRB contains onh/ one "parameter: the SVC function code '1 A = ExitV No other 
parameters are needed. 

TSIZE EQU 5. This directive assigns the value 5 to the symboi TSiZE. Other statements in the 
program use the symbol TSIZE when referring to the size of the table of numbers to be added. 

ORG BOOH. This directive specifies that the table will start at address 500. 

BLOCK TSIZE. This directive allocates 5 (TSIZE) bytes to the table. The contents of the table are 
undefined; you will put values into the table later in this demonstration. The symbol TABLE, 
which represents the address of the table (500), is used by the LXI instruction. 

LIST DBG. The LIST directive controls various assembler options. LIST DBG specifies that the 
symbols in your source code (START, LOOP, TSIZE, and TABLE) will be placed in the object file. 
Later in this demonstration, these symbols will be used in OS/40 commands and displays. 

EiSIO START. The END directive si'^nals th^ '^n'^ "^f the '^ourcs '^'^'^'^ and ^"^ecifies th^* ^TART i^ 
the transfer address: the address of the first instruction to be executed when you start the 
program with the G (Go) command. Since START is the label of the LXI instruction, that 
instruction will be executed first. 



How the Demonstration Program Works 

The steps of the program are illustrated in the flowchart in Fig. 1 -5. 

Set Table Pointer. The first instruction in the program, LXI H,TABLE, loads the address of the 
table (500) into the H-L register pair. As a result, the H-L register pair points to the first element 
of the table. The label START represents the address of this instruction. START is used by the 
END directive to specify that the LXI instruction is the first to be executed. 

Set Pass Counter. Register B is used as the pass counter. The MVI B,TSIZE instruction moves 
the value 5 into register B. This step sets the number of passes to 5. Each time a number is taken 
from the table and added into the accumulator, register B is decremented. 

Clear Accumulator. The XRA A instruction sets the accumulator to zero. We want the 
accumulator to be cleared when we start adding numbers from the table. 

Add Byte from Table. The ADD M instruction adds the data addressed by the H-L register pair 
into the accumulator. The label LOOP represents the address of this instruction; this label is 
used by the JNZ instruction. 
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Start 



Initialize table pointer 



Set pass counter 



Clear accumulator 



Add byte from table 



Point to new byte 



Reduce pass counter 



No 




3939-3 



Fig. 1-5. Demonstration program flowchart. 

This flowchart presents the algorithm for the program used in this demonstration run. The 
program adds the elements of a table in memory and leaves the sum in the accumulator. The 
demonstration run shows how to download the program into memory, execute the program, 
and monitor its execution. 



@ 
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Point to Next Byte. The INX H instruction increments the address in the H-L register pair; theH- 
L register pair then points to the next byte in the table. For example, the H-L register pair is 
initialized to contain the address 500. After the INX H instruction is first executed, the H-L 
register pair will contain 501, the address of the second element in the table. 

Decrement Pass Counter. The DCR B instruction decrements register B, the pass counter. In 
this program, because the DCR B instruction follows the ADD M instruction, the pass counter is 
decremented each time a number is added to the accumulator. 

Loop If Not Five Passes Yet. The JNZ instruction effectively checks the contents of register B 
and jumps to the LOOP label if the register does not contain zero. If register B contains zero, the 
program proceeds to the OUT 0F7H instruction. 

Exit. The OUT 0F7H instruction followed by the NOP is a call to the Exit SVC. This SVC invokes 
the operating system to handle termination of the program. A NOP always follows an SVC 
invocation to allow the system time to execute the SVC. 



Assemble and Load the Demonstration Program 

Now it's time to create the program so you can run it on your emulator. One of the following 
discussions describes the set of steps that is appropriate for your hardware configuration: 

• For 8560 users: Case 1 : Assemble on the 8560; Download to the 8540 

• For users with host computers other than the 8560: Case 2: Downloadfrom Your Host to 
the 8540 

® For other hardware configurations: Case 3: Patch the Program into IVIemory. 

Go ahead and work through the discussion that's appropriate for you. Once you've put the 
program into program memory, turn to the heading "Run the Demonstration Program," later in 
this section. 



Case 1 : Assemble on the 8560; Download to the 8540 

This discussion shows you how to create the demonstration program source code and assemble 
it on the 8560, then download it to 8540 program memory. If your 8560 does not have an 
8080A/8085A assembler, you cannot complete this part of the demonstration, so skip ahead to 
the heading "Case 3: Patch the Program into Memory" for instructions. 



Start Up and Log In 

Start up your 8540, make sure it's in TERM mode, and log in to the 8560 operating system, as 
described earlier in this Learning Guide. 
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Since you're logged in to TNIX, your system prompt is "$". (Later in the demonstration, we'll 
show the system prompt as ">", in deference to people using 8540s in LOCAL mode.) Every 
command you enter is processed by TNIX. If you enter an OS/40 command, TNIX passes it to the 
8540. 

Enter the following line to select the 8080A/8085A assembler on the 8560: 

$ uF=8085; export uF <CR > 

Now select the 8085A emulator on the 8540: 

$ sel 8085 <CR> 

The sel command automatically sets the emulation mode to 0. 



Create the Demonstration Program 

Enter the following TNIX command lines to create an empty directory called demo and make 
demo the working directory. You'll create your source file and related files in this demo 
directory. 

$ mkdir demo <CR> 
$ cd demo <CR> 

Now use the TNIX editor, ed, to create the demonstration program source file. The following 
command line invokes the editor and specifies that you want to create a file called asm: 

$ ed asm <CR> 
?asm 

The editor responds "?asm" to remind you that asm does not already exist. Notice that the editor 
does not give a prompt to let you know it's ready for input. 
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Enter the Text- Nnw enter the editor command a (add text) and type In the program. Use the 
BACKSPACE key to erase typing mistakes. 

a <CR> 

colunun column column 



i \ i 

;8085 DEMONSTRATION RUN PROGRAM <CR> 





SECTION 
ORG 


DEMO 
lOOH 


<CR> 

; START PROGRAM CODE AT ADDRESS 100 


START 


LXI 


RATABLE 


SET TABLE POINTER <CR> 




MVI 


B.TSIZE 


SET PASS COUNTER <CR> 




XRA 


A 




CLEAR ACCUMULATOR <CR> 


LOOP 


ADD 


M 




ADD BYTE FROM TABLE <CR> 




INX 


H 




POINT TO NEXT BYTE <CR> 




DCR 


g 




DECREMENT PASS COLWIER <CR> 




JNZ 


LOOP 




LOOP IF NOT FIVE PASSES YET <CR> 




OUT 


0F7H 




OTHERWISE CALL EXIT SVC <CR> 


NOP 


TO END PROGRAM EXECUTION <CR> 



;SRB POINTER <CR> 



40H 



ORG 



; STORE SRB POINTER AT ADDRESS 40 <CR> 



BYTE 00,42H 


; POINT TO SRB FOR EXIT SVC <CR> 


;3RB FOR EXIT SVC <CR> 




BYTE lAH 


;1AH = FUNCTION CODE FOR EXIT SVC 


; TABLE OF NUMBERS TO BE 


ADDED <CR> 


TSIZE EQU 5 


; TABLE SIZE = 5 <CR> 


ORG 500H 


;SET UP TABLE AT ADDRESS 500 <CR> 



TABLE BLOCK TSIZE <CR> 



LTST 



END 



DBG <CR> 
START <CR> 



^ <CR> 

At the end of your text, enter a period on a line by itself. The editor wil! go back to accepting 
commands. 



Check for Errors. Enter the following editor command to display the text you have entered. 
Check for typing mistakes. 

l,$p <CR> 



M*_ 



print command: displays the lines 
in the designated range 

-designates last iine in file 

■ designates first line in file 



If you made any mistakes, go ahead and fix them. In case you're not familiar with ed, Table 1 -3 
lists the commands you need in order to add, delete, or replace any line. For more information on 
ed, refer to your 8560 System Users Manual. 
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Table 1-3 
Basic 8560 Editing Commands 



Command 


Function 


mm,nnp <CR> 


Displays lines mm through nn 


nn <CR> 


Makes line nn the current line 


d <CR> 


Deletes the current line 


a <CR> 

<line(s) of text> 
. <CR> 


Adds text after the current line 


c <CR> 

<line(s) of text> 
. <CR> 


Replaces the current line with the text you type in 



Once your text is correct, enter the w command to write the text to the source file, asm: 

_w <CR> 
896 

The editor responds with the number of characters it wrote to the file. 
Finally, enter the q command to quit the editor and return to TNIX: 

q <CR> 

$ -^ TNIX prompt 



Assemble the Source Code. TheTNIX asm (assemble) command translates assembly language 
(source code) into binary machine language (object code). The asm command also creates an 
assembler listing which can be used to correlate the object code with the source code. Enter the 
following command line to assemble the source code in the file asm and create the listing and 
object files asmi and obj: 

$ asm obj asml asm <CR> 



L 



source file 



■assembler listing file 



object file 



Tektronix ASM 8080/8085 
Vxx . xx-xx ( 8560 ) 

*****Pass 2 

23 Lines Read 

23 Lines Processed 

Errors 



Enter the following command to print the assembler listing on the 8560's line printer: 

$ Iplr asml <CR > 
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Check page 1 of your listing. Did the assembler issue any error messages? There should be none. 
If your source code contains errors, take the following steps: 

1 . Refer to your Assembler Users Manual to find out what the error messages mean. 

2. Enter the command ed asm to get back into the editor and fix the mistakes in your source 
code. Exit the editor with the w and q commands, as before. 

3. Enter the command asm obj asm! asm to re-assemble your source code. 



Link the Object Code 

The linker creates an executable load file from one or more object files. Enter the following 
command to create a load file called load from your object file, obj. Be sure to capitalize all 
parameters as shown. 

$ link -d -0 obj -o load <CR> 

The -d option causes the linker to pass the program symbols from the object file to the load file, 
for use in programming debugging. 

The files generated by the asm and link commands should now be in your working directory, 
demo. Enter the following command to list the files in your working directory: 

$ Is <CR> 

asm 

asml 

load 

obj 

Notice that there are now four files listed in your directory, obj and asml were created by the 
assembler, ano loao was created oy tne nnker. 



Download the Program to the 8540 

Now it's time to download the object code produced by the 8560's linker into 8540 program 
memory. 

Zero Out Memory. Before you download any code, use the OS/40 F (Fill) command to fill 8540 
program memory with zeros. Later, when you examine memory, the zeros make it easy to 
identify the beginning and end of your code. (Zeroing out memory has no effect on how the 
program is loaded.) Enter the following command line to fill memory from address 40 through 
address IIP with zeros: 

$ f 40 llf 00 <CR> 
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Check That Memory Was Filled with Zeros. Check the contents of memory with the OS/40 D 
(Dump) command. The D command's display shows the data in hexadecimal format, and also 
shows the corresponding ASCII characters. Display the contents of memory addresses 40-1 1 F 
with the following command line: 

$ d 40 llf <CR> 

01E3456789ABCDEF 

000040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000050 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000070 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000090 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOAO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOBO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOCO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOODO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOEO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOFO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000110 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 



Download the Object Code. Enter the following command line to download the object code 
from the 8560 file load to 8540 program memory: 

$ lo <load <CR> 



load file 



Download the Program Symbols. Recall that the source code for the demonstration program 
contains the directive LIST DBG. Because of this directive, the object file contains a list of the 
symbols that appear in the source code, and the values associated with those symbols. Because 
you included the -d option in the link command line, those symbols were passed to the load file. 
Use the OS/40 SYMLO command to download those symbols into the symbol table in 8540 
system memory. 
$ symlo -s <load <CR> 

The -S option means that both addresses and scalars are downloaded. If you omit the -S, only 
addresses are downloaded. (A scalar is a number that is not an address — for example, TSIZE, the 
length of the table.) 

Later in this demonstration, whenever you use a symbol in an OS/40 command line, OS/40 
refers to the symbol table to find the value that the symbol stands for. 

You've assembled and linked the demonstration program and downloaded it into memory. Now 
skip ahead to the heading "Run the Demonstration Program." 
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Case 2: Download from Your Host to the S540 

This discussion gives some general instructions for downloading the demonstration program 
from an unspecified host computer to 8540 program memory. If your 8540 is not equipped with 
the optional COM Interface Package, you cannot complete this part of the demonstration, so skip 
ahead to the heading "Case 3: Patch the Program into Memory" for instructions. 



Since we don't know what host computer you're using, we can only provide a general outline for 
creating the demonstration program and downloading it to the 8540. Once you have determined 
the command sequence that is appropriate for your host, record this information in the space 
provided in 1 -6. 



Create the Extended Tekhex Load Module 



Prepare the 8540 

(Start up the 8540, 

> SEL 8085 <CR> 

> F 40 IIF 00 <CR> 

> D 40 IIF <CR> 

Establish Communication 



Download the Load Module 



Terminate Communication 



Fig. 1-6. Host computer commands for preparing demonstration program. 
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Create the Extended Tekhex Load Module 

In order for the object code to be downloaded to the 8540, it must be in Extended Tekhex format, 
as shown in Fig. 1 -4, earlier in this demonstration. You can create the load module in one of two 
ways: 

1. Use your host computer's text editor, and key the load module in by hand. 

2. Use your host computer's 8085A assembler: 

a. Translate the demonstration program into the language of your host's 8085A 
assembler. 

b. Create and assemble the source file. 

c. Link the object code, if necessary. 

d. Translate the object code produced by the assembler or linker into Extended Tekhex 
format. The Intersystem Communication section of this manual provides a general 
algorithm for conversion to Extended Tekhex format. 



Prepare the 8540 

Start up your 8540 and enter the following command to select the 8085A emulator: 

> SEL 8085 <CR> 

The SEL command automatically sets the emulation mode to 0. 

Zero Out Memory. Before you download any code, use the OS/40 F (Fill) command to fill 8540 
program memory with zeros. Later, when you examine memory, the zeros make it easy to 
identify the beginning and end of your code. (Zeroing out memory has no effect on how the 
program is loaded.) Enter the following command line to fill memory from address 40 through 
address 1 1 F with zeros: 

> F 40 IIF 00 <CR> 



Check That Memory Was Filled with Zeros. Check the contents of memory with the OS/40 D 

(Dump) command. The D command's display shows the data in hexadecimal format, and also 
shows the corresponding ASCII characters. Display the contents of memory addresses 40-1 1 F 
with the following command line: 

> D 40 IIP <CR> 

0123456789ABCDEF 

000040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000050 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000070 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000090 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOAO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOBO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOCO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOODO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOEO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOFO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000110 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 



ra 
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Download the Load Module to the 8540 

Be sure that your 8540 and your host computer are connected via an RS-232-C-compatible 
communications link. Then perform the following steps to download the Tekhex load module to 
8540 program memory. (Refer to the Intersystem Communication section of this manual to 
determine the commands and parameters that are appropriate for your host computer.) 

a. Enter the 8540 COM command to establish communication. (The parameters of the 
COM command are host-specific.) Log on to your host and execute any necessary 
host initialization commands. 

b. Enter the command line that downloads the Tekhex load module to the 8540. This 
command line consists of a host computer command that performs the download, 
followed by a null character (CTRL-@ on most terminals) and a carriage return. COM 
places the object code in 8540 program memory, and puts the program symbols into 
the symbol table in 8540 system memory. 

c. Log off from your host, and then terminate COM command execution by entering the 
null character, then pressing the ESC key. 

Once you've downloaded the program to the 8540, skip ahead to the heading "Run the 
Demonstration Program." 



Case 3: Patch the Program into Memory 

This discussion shows you how to patch the demonstration program into 8540 program memory 
using the P command, and then add the program symbols into the symbol table using the ADDS 
command. 

Ordinarily, you would download the object code and symbols from a binary or hexadecimal load 
file on a host computer, as illustrated for Cases 1 and 2. The procedure presented here is not 
normally used for preparing a program for execution. Use this procedure only if you have no 
standard means for preparing the program, but would still like to try out your emulator. 



Start Up the 8540 

Start up your 8540 and enter the following command to select the 8085A emulator: 

> SEL 8085 <CR> 

The SEL command automatically sets the emulation mode to 0. 



Zero Out Memory 

Before you patch in any code, use the OS/40 F (Fill) command to fill 8540 program memory with 
zeros. Later, when you examine memory, the zeros make it easy to identify the beginning and 
end of your code. Enter the following command line to fill memory from address 40 through 
address 1 1F with zeros: 

> F 40 IIF 00 <CR> 
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Check That Memory Was Filled with Zeros. Check the contents of memory with the OS/40 D 
(Dump) command. The D command's display shows the data in hexadecimal format, and also 
shows the corresponding ASCII characters. Display the contents of memory addresses 40-1 1 F 
with the following command line: 



> D 40 
000040 


IIF < 
1 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 


2 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 


3 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 


4 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 


5 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 


6 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 


7 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 


8 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 


9 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 


A 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 


B 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 


c 

00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


D 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 


E 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 


F 

00 


000050 


00 


000060 


00 


000070 


00 


000080 


00 


000090 


00 


OOOOAO 


00 


OOOOBO 


00 


OOOOCO 


00 


OOOODO 


00 


OOOOEO 


00 


OOOOFO 


00 


000100 


00 


000110 


00 



Patch the Object Code into Memory 

The OS/40 P (Patch) command stores a sequence of bytes into memory, replacing the previous 
memory contents. Enter the following command to store the object code for the first three 
instructions in the program (LXI, MVI, and XRA) starting at location 100: 

> P 100 210005 0605 AF <CR> 



^ ^ 



XRA A 
MVI B,TSIZE 
LXI HJABLE 
patch address 



Now patch in the next four instructions (ADD, INX, DCR, and JNZ)... 

> P 106 86 23 05 C20601 <CR> 

... and now the last two instructions (OUT and NOP): 

> P 100 D3F7 00 <CR> 

Finally, patch in the Exit SVC information at address 40: 

> P 40 00421A <CR> 

You'll check the contents of memory later in this demonstration. 
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Put Symbols into the Symbol Table 

Later in this demonstration, you will use symbols from the demonstration program (START, 
LOOP, TSIZE, and TABLE) when communicating with 08/40. Whenever you use a symbol in a 
command line, OS/40 consults a symbol table in 8540 system memory to find the values that 
the symbol stands for. Enter the following command line to add the program symbols to the 
symbol table, along with their values: 

> ADDS START-100 L00P=106 -S TSIZE=5 TABLE=500 <CR> 

The -S parameter indicates that TSIZE is a scalar, not an address. 

The ADDS command cannot provide all the symbol-related information that is provided by the 
SYMLO command (as in Case 1) or the COM command (as in Case 2). Because this information is 
missing, some of the symbolic displays you produce later in this demonstration will not match 
the displays shown in this manual. For more information on the ADDS command, refer to the 
Command Dictionary of this manual. 

You've patched the demonstration program into program memory and placed the program 
symbols in the symbol table. Now it's time to run the program. 



Run the Demonstration Program 

From now until the end of the demonstration, the commands you are to enter are shown in 
lowercase. If you are not logged in to an 8560, you may enter commands in either lowercase or 
uppercase. If you are using an 8560, you must enter the name of every command in lowercase 
(and your system prompt is "$", not ">"). 

Now that you've loaded the program into memory, you need to; 

1 . verify that the program was loaded correctly 

2. put values into the table in memory, for the program to add. 

Check Memory Contents Again. Before you loaded the program, you filled memory locations 
40-1 IF with zeros. Look at the same memory area again with the following command line: 

> d 40 111" <CR> 

0123456789ABCDEF 

000040 00 42 lA 00 00 00 00 00 00 00 00 00 00 00 00 00 . B 

000050 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000070 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000090 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOAO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOBO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOCO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOODO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOEO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOFO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000100 £1 00 05 06 05 AF 86 23 05 C2 06 01 D3 F7 00 00 ! # 

000110 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
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The object code is loaded in two different blocks; 

• The 8085A machine instructions are loaded at address 100 (specified by the first ORG 
directive in the source code). 

• The information for the Exit SVC is loaded at address 40 (specified by the second ORG 
directive). 

The contents of the table at address 500 are still undefined, but you'll put some values into the 
table in just a few minutes. 

Turn On Symbolic Display. Enter the following command to tell OS/40 to modify its displays by 
replacing hexadecimal numbers with symbols from your program, where appropriate: 

> symd on <CR > 

Disassemble the Object Code. The Dl (Disassemble) command displays memory contents both 
in hexadecimal notation and in assembly language mnemonics. You can use the Dl command to 
verify that the object code in memory corresponds to your source code. Enter the following 
command to disassemble the area of memory occupied by the executable part of your program: 

> di 100 lOe <CR> 



LOG 


INST 


MNEM 


OPER 


SECTION 


(DEMO) 






START 


210005 


LXI 


H,0500 


+000103 


0605 


MVI 


B,05 


+000105 


AF 


XRA 


A 


LOOP 


86 


ADD 


M 


+000107 


23 


INX 


H 


+000108 


05 


DOR 


B 


+000109 


C20601 


JNZ 


0106 


+00010C 


D3F7 


OUT 


F7 


+00010E 


00 


NOP 





Compare the Dl display with the assembler listing you generated earlier, or refer back to Fig. 1 -3. 

The line "SECTION (DEMO)" in the Dl display indicates that the object code being disassembled 
comes from the program section called DEMO. In fact, the entire memory area used by your 
program (location through the end of the table — location 504) belongs to section DEMO. This 
section was declared by the SECTION directive in the source code. (If you used the ADDS 
command to create your symbols, as in Case 3, the section name shown in the Dl display is 
NO. SECTION.) 

The LOC (location) column of the Dl display contains information that enables you to correlate 
the display with your assembler listing. The symbols START and LOOP in the Dl display 
correspond to the labels START and LOOP in the source code. For those lines of the display 
where the location does not correspond to a label in the symbol table, Dl substitutes the address 
of the instruction relative to the beginning of the section, as shown in the address field of your 
assembler listing. If you don't load the pertinent symbols and related information into the symbol 
table (using a command such as SYMLO), the Dl command supplies absolute(actual) addresses 
in the LOC column. (Since section DEMO begins at address 0, the relative address, or offset, is 
the same as the absolute address in this display. This offset feature is much more useful for 
sections that don't start at address 0.) 
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Now you've seen that OS/40 can use the symbol table to translate numbers into symbols to 
make a display easier to read. OS/40 can also translate a symbol in a command line into an 
address. For example, since OS/40 knows that the symbol START is equivalent to the address 
100, you could have entered the Dl command in any of the following ways: 

ui 100 iOE 

di START IOE 

di start start+Oe 

di 100 START+OE 

Notice that a symbol can be entered in either lowercase or uppercase. 

The feature that enables OS/40 to correlate symbols from your program with the numbers they 
represent is termed symbolic debug. 

Put Values into the Table in Memory. The demonstration program sums five numbers from a 
table in memory. Use the P (Patch) command to store the numbers 1,2,3,4, and 5 intothetable. 
Do you remember what the address of the table is? It doesn't matter, as long as you remember 
that the symbol TABLE represents that address. 

> p table 0103050405 <CR> 

address of string of bytes to be stored 
table: 500 at addresses 500-504 

Check the Contents of the Table. Use the D command to display the contents of the table. 
(When you don't specify an upper boundary for the area to be dumped, the D command dumps 1 6 
bytes.) 

lower address: 500 



— upper address: omitted 

(defaults to lower address + OF) 

t 

> d table <CR> 

0123456789ABCDEF 
000500 01 02 03 04 05 CD 4E 04 3A C7 16 FE 00 CA 35 05 



Notice that bytes 500-504 (the table) contain the values you patched in. Bytes 505-50F contain 
random data left over from previous system operations. 

The following command dumps only the contents of the table: 

> d table table+tsize-1 <CR> 

0125466 7 ByABCDEF 
000500 01 02 03 04 05 
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Start Program Execution 

Enter the G (Go) command to start program execution at location 100, the transfer address 
specified by the END directive in the source code. (If you followed "Case 3: Patch the Program 
into Memory," you must enter "g start" instead.) 

> g <CR> 



LOG INST MNEM OPER SP F ABCDEHLIM SOD 

SECTION (DEMO) 

+00010F 00 NOP 0000 54 ^3, 00 00 00 05 05 00 

+00010F <BREAK > i A ' ' 

I I table 

accumulator pass pointer 

counter 



The program executes, and when the Exit SVC occurs, the program breaks (stops), and the 
contents of the emulator registers are displayed. The accumulator contains the sum of the 
numbers in the memory table: 1 +2+3+4+5=0F. 



Monitor Program Execution 

You have assembled, loaded, and executed the demonstration program. The rest of this 
demonstration shov^/s you some commands for monitoring program execution. You can watch 
the changes in the emulator's registers and observe the effect of each instruction as the 
program proceeds. 

Trace All Instructions. The TRA (TRAce) command lets you observe the changes in the 8085A 
registers as the program proceeds. When you enter a TRA command and then start execution 
with the G command, display lines are sent to the system terminal. As each instruction 
executes, the display line shows the instruction (as in the Disassemble display) and the contents 
of the registers after that instruction has executed. Enter the following command to trace all of 
the program's instructions: 

> tra all <CR> 

Enter the command G START (or G 1 00) to resume program execution back at the beginning of 
the program: 

> g start <CR> 
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As thfi program executes, the foHowing trace is displayed. Remember that ycu can type CTRL S 
to suspend the display and CTRL-Q to resume the display. 

LOG INST MNEM OPER SP F A B C D E H L IM SOD 
SECTION (DEMO) 



on nnne^ t vt 



+000103 

+000105 

LOOP 

+000107 

+000108 

+000109 

LOOP 

+000107 

+000108 

+000109 

LOOP 

+000107 

+000108 

+000109 

LOOP 

+000107 

+000108 

+000109 

LOOP 

+000107 

+000108 



0605 

AF 

86 

23 

05 

020601 

86 

23 

05 

C20601 

86 

23 

05 

C20601 

86 

23 

05 

020601 

86 

23 

05 



MVI 
XRA 
ADD 
INX 
DOR 
JNZ 
ADD 
INX 
DOR 
JNZ 
ADD 
INX 
DOR 
JNZ 
ADD 
INX 
DCR 
JNZ 
ADD 
INX 
DCR 



B,05 

A 

M 

H 

B 

0106 

M 

H 

B 

0106 

M 

H 

B 

0106 

M 

H 

B 

0106 

M 

H 

B 



0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 



54 
44 
00 
00 
10 
10 
04 
04 
14 
14 
04 
04 
10 
10 
04 
04 
10 
10 
04 
04 
54 



OF 05 

00 05 

01 05 
01 05 
01 04 
01 04 
03 04 
03 04 
03 03 
03 03 
06 03 
06 03 
06 02 
06 02 
OA 02 
OA 02 
OA 01 
OA 01 
OF 01 
OF 01 
OF 00 



uu wu uu 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 
00 00 00 



\JO uu 

05 00 
05 00 
05 00 
05 01 
05 01 
05 01 
05 01 
05 02 
05 02 
05 02 
05 02 
05 03 
05 03 
05 03 
05 03 
05 04 

05 04 

06 04 
05 04 
05 05 
05 05 



uu u 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 



LOG INST MNEM OPER 
SECTION (DEMO) 
+000109 C20601 JNZ 0106 
+00010C D3F7 OUT F7 
+00010C <BREAK TRACE > 



SP 



A B C D E H L IM SOD 



0000 54 OF 00 00 00 00 05 05 00 
0000 54 OF 00 00 00 00 05 05 00 



After the accumulator is cleared, it begins to store the sum of the numbers being added. The 
ADD M instruction adds a number from the table into the accumulator. At the end of the 
program, the accumulator contains the sum of the numbers you put into the table. 

Register B, the pass counter, is set to contain 5 (TSIZE) at the beginning of the program. It 
decreases by one (because of the DCR B instruction) each time a number is added into the 
accumulator. The program ends after register B reaches zero. 

The H-L register pair, set to contain 500 (TABLE) at the start of the program, increases by one 
(because of the INX H instruction) each time a number is added to the accumulator. At the end of 
the program, the register pair has been incremented five times and contains 505. 

Trace to the Line Printer. By adding the parameter >LPT to a command, you can direct that 
command's output to the line printer instead of to the system terminal. First, verify that your line 
printer is properly connected and powered up. Then enter the following command to execute the 
program with trace output directed to the line printer: 



I -JO 



fa) 
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NOTE 

If you are operating in TERM mode with an 8560, use one of tfie following commands 
in place of the command shown: 

• g start llplr sends the display to the 8660' s line printer. 

• g start \> LPT sends the display to the 8540 s line printer. 

> g start >LPT <CR> 



Trace Jump Instructions Only. Another way to monitor the program's execution is to look only 
at the jump instructions. By tracing the jump instructions, you can still observe the changes in 
the registers, but you save time and space by not tracing the instructions within the loop. Enter 
the following command to trace only the jump instructions when the loop is being executed: 

> tra jmp loop 109 <CR> 



t 



upper address 

lower address 
(106) 



Within this range, 
only jump instructions 
are traced. 



Check the Status of the Trace. The TRA command without any parameters displays the trace 
conditions that are currently set. Because you can have up to three trace selections in effect at 
the same time, it can be useful to be able to see which selections are active. Check your trace 
status with the following command line: 

> tra <CR> 

TRACE ALL, 000000, OOFFFF 
TRACE JMP, LOOP, 000109 

As you've specified, TRA ALL is in effect for addresses 0-1 05, TRA JMP is in effect for addresses 
106-109, and TRA ALL is again in effect for addresses 10A-FFFF. 

Again, start your program with the G command. The following trace is displayed: 

> g start <CR> 



LOC 


INST 


MNEM 


OPER 


SP 


F 


A 


B 


C 


D 


E 


H 


L 


IM 


SO] 


SECTION 


(DEMO) 




























START 


£10005 


LXI 


H,0500 


0000 


54 


OF 


00 


00 


00 


00 


05 


00 


00 





+000103 


0605 


MVI 


B,05 


0000 


54 


OF 


05 


00 


00 


00 


05 


00 


00 





+000105 


AF 


XRA 


A 


0000 


44 


00 


05 


00 


00 


00 


05 


00 


00 





+000109 


C20601 


JNZ 


0106 


0000 


10 


01 


04 


00 


00 


00 


05 


01 


00 





+000109 


C20601 


JNZ 


0106 


0000 


14 


03 


03 


00 


00 


00 


05 


02 


00 





+000109 


C20601 


JNZ 


0106 


0000 


10 


06 


02 


00 


00 


00 


05 


03 


00 





+000109 


C20601 


JNZ 


0106 


0000 


10 


OA 


01 


00 


00 


00 


05 


04 


00 





+00010C 


D3F7 


OUT 


F7 


0000 


54 


OF 


00 


00 


00 


00 


05 


05 


00 





+00010C 


<BREAK 




TRACE > 

























As with the TRA ALL display, observe that register B (the pass counter) is decremented; the H-L 
register pair (the table pointer) is incremented; and the accumulator stores the sum of the 
numbers from the table. With the TRA JMP selection in effect, the instructions within the loop 
are not displayed. 
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oct a orcaiipoint. i^uvv that you've 566ii huw the proyrani duds the iiUiiibers tuycther, here's a 
new task: to add only the third and fourth numbers from the table. To perform this task, you want 
the pass counter to contain 2, and the table pointer to contain 502 (the address of the third 

niimKor in tho tpK|p\ Vr^i i np^n apr*r»mnl'cK thiooQ nhonnpc \A/ith/-i""+ altprinri tKo rkKioot nr\r\a in 

memory. First, stop program execution after the pass counter and the table pointer have been 
set. Next, while the program is stopped, enter new values for the pass counter and table pointer. 
When execution resumes, the program will treat the new values as if they were the original 
programmed values. 

Enter the following command line to trace all of the instructions as the program executes: 

> tra all <CR> 

Check the status of the trace with the following command line: 

> tra <CR> 

TRACE ALL, 000000, OOFFFF 

The trace selections you set earlier are made obsolete by the TRA ALL command just entered. 



Now you set a breakpoint so that the program stops after the table pointer and pass counter have 
been set. The following command will cause the program to stop after it executes the MVI 
instruction at address 103: 

> bk 1 103 <CR> 



1 



L 



breakpoint address 

■ breakpoint number 
(can be 1 or 2) 



Use the G command to start program execution: 

> g start <CR> 



LOG INST MNEM OPER SP F A B C D E H L IM SOD 
SECTION (DEMO) 

START 210005 LXI H,0500 0000 54 OF 00 00 00 00 05 00 00 
+000103 0605 MVI B,05 0000 54 OF 05 00 00 00 05 00 00 
+000103 <BREAK TRACE, BKPT1> 



The TRA ALL command enabled display of all instructions up to and including the instruction at 
the breakpomt. 



Set New Values in Pass Counter and Table Pointer; Check Results. Now that you've reached 
the breakpoint, you can change the contents of the registers while execution is stopped. The 
break display shows that register B (the pass counter) contains 5, and the H-L register pair (the 
table pointer) contains the address 500. Use the S (Set) command to set the number of passes to 
two and set the table pointer to 502. 

> s B=2 L=2 <CR> 



i t_ 



contents of tow byte 
of H-L register pair 

.contents of register B 
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The S command does not produce a display, but you can use the DS (Display Status) command to 
check the values in the registers you changed. DS displays the contents of each emulator 
register and status flag. Check the result of the previous S command with the following 
command line: 

> ds <CR> 

PC=0105 SP=0000 F=54 A=OF B=02 C=00 D=00 E=00 H=05 L=02 
SOD=0 SID=0 17=0 16=0 15=0 IE=0 M7=l M6=l M5=l 

The DS display shows that the pass counter and table pointer now contain the new values. 

Resume Program Execution. If you enter the G command with no parameters, program 
execution starts where it left off. Resume program execution after the breakpoint with the 
following command: 

> g <CR> 



LOG 


INST 


MNEM 


OPER 


SP 


F 


A 


B 


C 


D 


E 


H 


L 


IM 


SO] 


SECTION 


(DEMO) 




























+000105 


AF 


XRA 


A 


0000 


44 


00 


02 


00 


00 


00 


05 


02 


00 





LOOP 


86 


ADD 


M 


0000 


04 


03 


02 


00 


00 


00 


05 


02 


00 





+000107 


23 


INX 


H 


0000 


04 


03 


02 


00 


00 


00 


05 


03 


00 





+000108 


05 


DCR 


B 


0000 


10 


03 


01 


00 


00 


00 


05 


03 


00 





+000109 


C20601 


JNZ 


0106 


0000 


10 


03 


01 


00 


00 


00 


05 


03 


00 





LOOP 


86 


ADD 


M 


0000 


00 


07 


01 


00 


00 


00 


05 


03 


00 





+000107 


23 


INX 


H 


0000 


00 


07 


01 


00 


00 


00 


05 


04 


00 





+000108 


06 


DCR 


B 


0000 


54 


07 


00 


00 


00 


00 


05 


04 


00 





+000109 


C20601 


JNZ 


0106 


0000 


54 


07 


00 


00 


00 


00 


05 


04 


00 





+00010C 


D3F7 


OUT 


F7 


0000 


54 


07 


00 


00 


00 


00 


05 


04 


00 





+00010C 


<BREAK 


TRACE > 

























Notice that the program performed two passes through the loop, and that the program added the 
third and fourth numbers in the table: 3+4=7. 



Summary of Emulator Demonstration Run 

You have assembled, loaded, executed, and monitored the demonstration run program. Review 
the commands you used: 

• SEL— selects the 8085A assembler and emulator 

• ASM (TNIX command) — creates object code from an assembly language program 

• LINK (TNIX command)— links object code into a load module 

• F — fills an area of memory with a specified value 

• D— displays memory contents in ASCII and hexadecimal format 

• LO or COM — downloads object code into memory 

• SYMLO or COM — downloads program symbols for use in symbolic debug 

• Dl — translates memory contents into assembly language mnemonics 

• P — patches a string of bytes into memory 

• G — begins or resumes program execution 

• TRA — selects instructions to be traced during program execution 
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• BK — sets a breakpoint 

• S — modifies emulator registers 

• DS — displays emulator registers 



Delete the Demonstration Run Files 

Now that you've finished the demonstration run, you can delete the files you created on the host. 
If your files are on the 8560, you can use the following procedure to delete them. 

Enter the following command to remove all the files in the working directory: 

$ rm * <CR> 

Now move from the demo directory back into the parent directory and remove the demo 
directory itself: 

I cd ■ ■ <CR> 

$ rmdir demo <CR> 

iC lOg out riuiii y«jui ouuv^ aiiu iciuiii yuui ouM-u lu i-wo/-\t- rriuuc, lypc 

$ config local; logout <CR> 

You can turn off the 8540 and its peripherals in any order. 



FOR CONTINUED LEARNING 

This Learning Guide introduced the basic concepts needed to use your 8540 It gave you an 
overview of the 8540 and related products, and showed you howtoprepare, download, execute, 
and monitor a program. To obtain more detailed explanations of various 8540 operations, refer 
to the following sections: 

Section 2, Operating Procedures. Describes a series of tasks and lists the commands needed 
to perform these tasks. 

Section 3, Command Dictionary. Provides a description and examples of each OS/40 
command. The Command Dictionary is arranged alphabeticaiiy by command name, it is 
preceded by a classified list of commands to help you choose a command by its function if you 
don't remember its name. 

Section 4, Intersystem Communication. Gives the technical information needed to set up 
communication between the 8540 and another computer system. 

Section 5, Emulation. Summarizes the emulation features of the 8540. The emulator 
demonstration run in this Learning Guide demonstrated program execution in emulation mode 
0. Section 5 discusses modes 1 and 2 as well, and gives detailed explanations of symbolic debug, 
the Memory Allocation Controller (MAC) option, and the Trigger-Trace Analyzer (TTA). 
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Section 6, Service Calls. Explainswhat service calls are and how you use them in your program 
to access I/O devices on the 8540 and files on the 8560. 

Section 7, Emulator Specifics. Provides a place to insert your Emulator Specif ics supplements. 
Each supplement gives reference information that is specific to a particular emulator, and also 
contains a demonstration run and installation instructions for that emulator. 

Section 8, PROM Programmer Specifics. Describes the general features and operation of the 
PROM Programmer. Add your PROM Programmer Specifics supplements to this section. Each 
supplement provides reference information that is specific to a particular PROM Programmer 
characteristic module. 

Section 9, Technical Notes. Provides miscellaneous technical information. Technical Note 1 
discusses the practical limits of emulation. Technical Note 2 summarizes the differences 
between 08/40 Version 1 and DOS/50 Version 2, the operating system of the 8550 
Microcomputer Development Lab. Technical Note 3 summarizes the differences between the 
RTPA and the TTA. 

Section 1 0, Error Messages. Explains each 08/40 error message, giving a description of the 
problem and possible solutions. 

Section 11, Tables. Summarizes reference information in tabular form. 

Section 12, Glossary. Defines special terms used in this manual. 

Section 13, Index. Gives you a place to start when you don't know where else to look. 



OVERVIEW OF 8540 USER MANUALS 

This subsection describes the types of user manuals you will receive as you add options to your 
8540 system, and explains how each manual relates to the product it documents. 



Core Manuals and Specifics Supplements 

Many software products produced by Tektronix have a microprocessor-independentpartanda 
microprocessor-specific part. The microprocessor-independent part is common to every 
product of the same type, and minimizes your effort in using your 8540 with a new 
microprocessor. The microprocessor-specific part allows you to exploit the features of the 
microprocessor you have chosen. 

For example, on the 8560, all B Series assemblers have the same standard directives, error 
messages, and special features, but each assembler supports the instruction set, addressing 
modes, and other features of a different microprocessor. 



1-41 



Overview of 8540 User Manuals Learning Guide— 8540 System Users 



To document software that has both microprocessor-independent and microprocessor-specific 
features, Tektronix provides core manuals and specifics supplements. 



Core Manuals 

A core manual is a looseleaf book that documents the microprocessor- independent features of a 
product. A core manual has at least one empty section into which specifics supplements are 
inserted. 

Examples of core manuals include: 

• the 8540 System Users Manual (this manual), which describes the standard features of 
OS/40 and introduces you to many system options. This manual has an Emulator Specifics 
section and a PROM Programmer Specifics section. 

• the 8500 Modular MDL Series Assembler Core Users Manual for B Series Assemblers, 
which tells you how to use the B Series Linker and Library Generator and describes the 
microprocessor-independent features of the B Series Assembler. This Assembler Users 
Manual has an Assembler Specifics section. (It also contains a Host Specifics section, 

oiiiv^c u oci ICO aasciiiuici a aic avaiiauic uii li ic oDuu aa vvcii ao iiic ouxjkj.) 



Specifics Supplements 

A specifics supplement is a relatively short document that is designed to be inserted into the 
Specifics section of a core manual. A specifics supplement explains the microprocessor-specific 
features of a software product. It usually tells how to install the software into the operating 
system and provides a microprocessor-specific demonstration run. 

Examples of specifics supplements include: 

• Emulator Specifics and PROM Programmer Specifics supplements to this manual 

• Assembler Specifics supplements to the Assembler Users Manual 



Stand-Alone Manuals 

Some products are either fully microprocessor-independent or fully microprocessor-specific. 
Such a product is documented in a single complete manual. 

An example of a stand-alone manual is the Trigger-Trace Analyzer Users Manual, which 
describes the TTA in detail and explains its various applications. 



Reference Booklets and Cards 

Most software products are also accompanied by a reference booklet or reference card that 
summarizes the most commonly used information from the user manual. 
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Section 2 
OPERATING PROCEDURES 



Section 1, the Learning Guide, presented a general 
overview of the 8540's operating system and a simple 
demonstration program. This section presents some 
common procedures using OS/40 commands with your 
8540 Integration Unit. Each procedure identifies para- 
meters that you supply when performing the procedure. 

The procedures in this section are given in the following 
format: 

Description: A summary of the action(s) performed by 

the procedure. 

Procedure: The information entered or displayed at 

the system terminal. 

The following conventions are used in 
the procedure description: 
Underlined : A character sequence entered 
by the user. 

No underline: A character sequence 
displayed by OS/40. 

Bold: An exact character sequence; if 
these characters are underlined, enter 
them exactly as shown. 

Not bold: A parameter that you supply 
when performing the procedure. 

Parameters: A description of the values to be supplied 

by you. 

Comments: The operating limits and options for this 

procedure. 

Examples: One or more demonstrations of correct 

entry format. 

See also: Cross-references to related procedures. 



COMMUNICATING WITH AN 
8560 

Establishing Communication with the 8560 

Description: This procedure establishes a TERM 

interface with an 8560. With your 8540 
and 8560 operating in TERM mode, you 



have access to ail resources of both 
systems simultaneously. 

The 8540 is connected to the 8560 by an 
HSI cable. The system terminal is 
connected to the 8540 by an RS-232-C 
cable. Figure 2-1 shows how the various 
units are connected together. 

Procedure: (Connect the cables as shown in Fig. 2-1 .) 

(Start up the 8540.) 

> config term <cr> 

<cr> 

Login: 

(Log in to the 8560.) 

Comments: Refer to your 8560 System Users Manual 

for more information concerning this 
procedure. 



















8560 
HSI I/O 










i 
232-C 


HSI 






TERMINAL 




RS- 




\ 












* 








TERMINAL HSI 
J104 

8540 










3« 


339-4 



Fig. 2-1. Hardware configuration for 8540/8560 interface. 



To communicate with an 8560, connect the cables as 
shown in this figure. 
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Downloading a Program From the 8560 
to 8540 Program Memory 

Description: This procedure downloads a file from the 

8560 to 8540 program memory. 

Procedure: $ !o <8560file 

Parameters: 8560fiie — The name of the 8560 file to 

load into 8540 program memory. 

Comments: To load an 8560 file into prototype 

memory, first select emulation mode 2, 
then follow the above procedure. 

NOTE 

The file must be in Tektronix A Series or B Series load 
module format, as produced by a Tektronix assembler 
or linker. 

See also: • Uploading a program from 8540 

program memory to the 8560 



Uploading a Program from 8540 
Program Memory to the 8560 

Description: This procedure saves a program from 

8540 program memory onto a file on the 
8560. 

Procedure: $ sav >8560file loadd hiadd transadd 

Parameters: 8560fiie — The 8560 file that is to receive 

the program from 8540 program memory. 

loadd — The lower limit of the data block 
to be saved. 

hiadd — The upper limit of the data block 
to be saved. 

transadd — The transfer address of the 
program. 

Comments: The file is created inTektronix ASeriesor 

B Series load module format, as produced 



See also: • Downloading a program from the 

8560 to 8540 program memory 



Downloading Program Symbols from the 
8560 

Description: This procedure loads the symbols from an 

8560 load file into the symbol table in 

OiJ"+w ayaiciii iiicmuiy. 

Procedure: $ symio <8560file -a -s 

Parameters: 8560file — The name of the 8560 load 

file containing the symbol definitions you 
want to load. 

NOTE 

The file must be in A Series or B Series load module 
format, as produced by a Tektronix linker. 

Comments: The -a option causes the command to 

append the symbols to those already in 
the table If you omit the -a, the existing 
symbols are overwritten. If you omit the 
-s, scalars are not loaded. 

See also: • Creating and defining a symbol 



Terminating Communication with an 8560 

Description: This procedure terminates communica- 

tion between the 8540 and the 8560. 

Procedure: $ config local; logout 

Comments: This command line breaks the communi- 

cation link between the 8540 and the 
8560. Both the 8540 and the 8560 are 
returned to normal operations. The 
CONFIG command tells the 8540 to stop 
passing commands to the 8560. The 
LOGOUT command tells TNIX (the 8560 
operating system) to stop accepting 
commands. 

See also: • Establishing communication with the 

occr* 
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Communicating with a Host Computer 



COMMUNICATING WITH A HOST 
COMPUTER 

Establishing Communication with the Host 
Computer 

Description: This procedure prepares the 8540 to 

operate as an "intelligent" terminal to a 
host computer. Six types of data transfer 
are available while communicating with 
a host computer. The two most commonly 
used data transfers are: 

1. A formatted download, which 
transfers an object file in Tekhex 
format from the host computer to 
8540 program memory. 

2. A formatted upload, which trans- 
fers object code in Tekhex format 
from 8540 program memory to a 
file on the host computer. 

Before establishing communication, you 
must first have attached your communi- 
cation link (a cable or modem) to the 
proper jack (usually J101) on the 8540 
rear panel. 

NOTE 

The following procedures are deliberately simplified 
because of the differences in host computer 
requirements. Refer to the Intersystem Communica- 
tion section of this manual, and to your system 



engineer, for the host-computer-specific commands 
and COM parameters that you will use in these 
procedures. 

Procedure: (Establish data transmission between the 

host computer and the 8540. See Fig. 2-2.) 
> com setup 

(Initialize your terminal session, as required 
by the host computer.) 

Parameters: setup — A sequence of parameters that 

informs the 8540 of the host computer- 
dependent features. Refer to the Inter- 
system Communication section of this 
manual to determine this sequence. 

Comments: After you have determined the specific 

procedure for establishing communica- 
tion with your host computer, record this 
information in the space provided in Fig. 
2-2. 

To terminate communication, enter the 
null character (ASCII 00) and press the 
ESC key on your terminal. On the 
TEKTRONIX 4024/4025 and CT8500 
terminals, the null character is generated 
by entering CTRL-@ (pressing the @ key 
while holding down the CTRL key). 

Other terminals may generate the null 
character differently. Refer to your 
terminal users manual for specific 
information. 
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Prepare the 8540: 



Enter the COM command: 



Host computer commands: 



(Record here the steps to be 

taken when preparing your 8540 

for communication with the 

host computer. See the Intersystem 

Communication section of this manual 

for more information.) 



(Record here the appropriate 
COM command parameters, as 
designated in the Intersystem 
Ocmmunicatscrs scctscn of this 
manual.) 



(Record here the host computer 

commands to initialize your 

terminal session.) 3939. 



Fig. 2-2. Establishing communication with the host computer. 



iv/t 1 1 lairui I I 



After vou have determined the specific procedure for establishing communication with your host computer, record tl 

the space provided in Fig. 2-2, for ease in future reference. Refer to the Intersystem Communication section ofthis manual for further 

information. 



Downloading a Program From the Host 
Computer to 8540 Program Memory 

Description: This procedure transfers a load file in 

Tekhex format from the host computer to 
8540 program memory (a formatted 
download). 



A program must be available on the host 
computer to send Tekhex blocks to the 
8540 and interpret the 8540's responses. 
Refer to the Intersystem Communication 
section of this manual for the require- 
ments of this program. 
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Procedure: (Establish communication with the host 

computer.) 

command(null ) 

(This command transfers a Tekhex format- 
ted file from the host computer to the 8540. 
The object code is loaded into program 
memory at the locations specified in the 
Tekhex data blocks. When transfer is 
complete, DNLOAD: is displayed and OS/40 
is ready to accept another upload or 
download command.) 

Parameters. command — A host computer command 

which invokes a program that downloads 
a Tekhex load module to the 8540. 

(null) — A character generated on most 
terminals by entering CTRL-@. 

See also: • Establishing communication with the 

host computer 



Uploading a Program from 8540 Program 
Memory to the Host Computer 

Description: This procedure transfers the contents of 

8540 program memory to the host 
computer in Standard or Extended 
Tekhex format (a formatted upload). You 
can use the F parameter of the COM 
command to distinguish between Standard 
Tekhex and Extended Tekhex. For more 
information about the COM command, 
refer to the Intersystem Communication 
section of this manual. 

A program must be available on the host 
computer to receive Tekhex blocks from 
the 8540. Refer to the Intersystem 
Communication section for the require- 
ments of this program. 

Procedure: (Establish communication with the host 

computer.) 

(Load into 8540 program memory the 
program that you want to upload.) 

command(null)loadd hiadd transadd 
(When the transfer is completed, UPLOAD: 
is displayed on the terminal. At this point, 
OS/40 is ready to accept another upload or 
download command.) 

Parameters: command — A host computer command 

which invokes a program that uploads a 



See also: 



Tekhex load module from 8540 program 
memory. 

(null) — A character generated on most 
terminals by entering CTRL-@. 

loadd — The lower boundary of the block 
of memory to be transferred. 

hiadd — The upper boundary of the block 
of memory to be transferred. 

transadd — The transfer address. 

• Establishing communication with the 
host computer 



Terminating Communication with the Host 

Description: This procedure terminates the communi- 

cation link between the 8540 and the 
host computer, returning the system to 
normal operation. 

Procedure: (Log out from the host computer.) 

(Enter a null character and press the ESC 

key:) 

(null)(ESC ) 

Comments: Enter the null character by entering 

CTRL-® (typing @ while holding down 
the CTRL key). 

See also: • Establishing communication with the 

host computer 



COMMUNICATING WITH AN 
8550 

Estabh'shing Communication with an 8550 

Description: This procedure prepares the 8540 for 

communication with an 8550 used asthe 
host computer. Six types of data transfer 
are available while communicating with 
the 8550; the two most common are: 

1 . A formatted download, which 
transfers a file in Tekhex format 
from the 8550 to 8540 program 
memory. 

2. A formatted upload, which trans- 
fers the contents of 8540 program 
memory in Tekhex format to a file 
on the 8550. 



(a) 
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Procedure: 



Comments: 



(Connect the RS-232-C cable, as described 
in the "Comments" part of this procedure.) 

(Enter tile foiiowiiiy uOiTirnand un the S54G 
terminal:) 

> com p=7E7E 

VyOlVI V A. A 

(Enter the following command on the 8550:) 

> host 



HOST Vx.x 

(The 8550 is ready to be used as the host 
computer. Subsequent displays and com- 
mands are at the 8540 system terminal. 
DOS/50 prompts you for a command which 
informs the 8550 of the type of transfer.) 

Enter U or D; A, B, or H; and 8550 
filespec: 

The 8550 must be connected to the 8540 
with an RS-232-C cable. The female end 
of the cable connects to the J1 01 jack on 
the 8540 mainframe. The male end 
connects to the DCE jack (J 102) on the 
8301. The MODE SELECT switches on 
both systems should be in the CNTL (L) 
position. To terminate communication 
enter {null)(esc) on the 8540. Then enter 
(CTRL-C) followed by the command a -a 
on the 8550. 

NOTE 

When the HOST command successfully completes a 
data transfer, the error code FF (end-of-file) Is 
returned to the 8550 system terminal. This does not 
signify an error condition; It Is merely an Informa- 
tional message. 

Certain limitations exist In the data transfer rate. See 
the Intersystem Communication section of this 
manual for Information concerning the baud rate. 

The HOST command waits about 30 seconds after 
each file transfer before Issuing the next prompt. 

See also: • Downloading a program from the 

8550 to 8540 program memory 

• Uploading a program from 8540 
program memory to the 8550 



rructjuurt;. 



Parameters: 



comments: 



Example: 



8550 to 8540 program memory (a 
formatted download). All commands are 
entered on the 8540 system terminal. For 
more information about Tekhex format, 
refer to the Tables section of this manual. 

(Establish communication between the 
8550 and the 8540.) 

Enter U or D; A, B, or H; and 8550 

filespec: 

DHfilespec 

Enter transfer sequence, beginning with 

null character: 

(null) 

filespec — The 8550 file containing the 
object program that you want to down- 
load to 8540 program memory. 

(null) — A character generated on most 
terminals by entering CTRL-@. 

The memory location and transfer ad- 
dress are specified by the contents of the 
object file. 



(Establish communication 
8550 and the 8540.) 



between the 



Enter U or D; A, B, or H; and 8550 filespec: 

DH/VOL/MYVOL/PROGl/LOAD 
Elnter transfer sequence, beginning 
with null character: 
(null) 
*0000 IE (First block sent to 

addresses 0000-OOlD. ) 
*001E IE (Second block sent to 
addresses 001E-003B.) 



*0200 0000 (Termination block- 
transfer address-0200 . ) 
ONLOAD: 

The Tekhex formatted file, /VOL/ 
MYVOL/PROGI/LOAD is downloaded 
to 8540 program memory. The memory 
locations and transfer address are speci- 
fied by the contents of the file. 



Downloading a Program from the 8550 
to 8540 Program Memory 

Description: This procedure transfers an executable 

object file in Tekhex format from the 



See also: • Establishing communication with an 

8550 

• Uploading a program from 8540 
program memory to the 8550 
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Downloading from an 8002A 



Uploading a Program from 8540 
Program Memory to the 8550 

Description: Tiiis procedure transfers the contents of 

program memory in the 8540 to an 8550 
Tekhex formatted file (a formatted up- 
load). All commands are entered on the 
8540 system terminal. For more informa- 
tion about Tekhex format, refer to the 
Tables section of this manual. 

Procedure: (Establish communication between the 

8550 and the 8540.) 

Enter U or D; A, B, or H; and 8550 

filespec: 

UHfilespec 

Enter transfer sequence, beginning with 

null character: 

(null)loadd hiadd transadd 

Parameters: filespec — The 8550 file that is to receive 

the data from the 8540. 

(null) — A character generated on most 
terminals by entering CTRL-(5). 

loadd — The lower boundary of the block 
of memory to be transferred. 

hiadd — The upper boundary of the block 
of memory to be transferred. 

transadd — The transfer address. 

Example: (Establish communication between the 

8540 and the 8550.) 

Enter U or D ; A, B, or H; and 8560 filespec: 

UH/VOL/MYVOL/PROGl/LOAD 
Enter transfer sequence, beginning 
with null character: 

(nulDOFOOO 0F3FF 0F200 



BLOCK SENT AT: 
BLOCK SENT AT: 



FOOD 

FOIE 



BLOCK SENT AT: F3FC 
BLOCK SENT AT: F200 
(Termination block.) 

UPLOAD: 

In this example, bytes F000-F3FF of 
program memory are uploaded to the 
8550 file /V0L/MYV0L/PR0G1 /LOAD 
in Tekhex format. F200 is the transfer 
address. 



See also: • Establishing communication with an 

8550 

• Downloading a program from the 
8550 to 8540 program memory 

Terminating Communication With an 8550 

Description: This procedure terminates the communi- 

cation link between the 8540 and the 
8550. 



Procedure: 



Comments: 



See also: 



(Enter (null)(ESC) on the 8540 terminal by 
typing CTRL-(a) and pressing the ESC key. 
Then enter the following commands on the 
8550 terminal.) 

( CTRL-C) 
>> a -a 

These commands terminate the com- 
munication programs that are running 
and return the systems to normal 
operation. 

• Establishing communication with an 
8550 



DOWNLOADING FROM AN 
8002A 

Downloading from an 8002A 

Description: This procedure transfers an executable 

object file in Tekhex formiat from the 
8002A to 8540 program memory. 

Procedure: (Establish communication between the 

8540 and the 8002A.) 
(Connect the RS-232-C cable, as described 
in the "Comments" part of this procedure.) 
(Enter the following command on the 8540 
system terminal:) 

> COM P=3F E=L L=l 

(Enter the following command on the 
8002A system terminal:) 

> SEND 

(Enter the following command on the 8540 
system terminal:) 
filename(null) 

(When the download is complete, the 8540 
terminal displays the message ONLOAD: 
(To terminate communication, enter (null) 
(ESC) on the 8540 terminal by typing CTRL- 
@ and pressing the ESC key.) 



(S 
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Parameters: filename — The name of the Tekhex file 

on the 8002A. 

(null)— A character generated on most 
terminals by entering CTRL-@. 

Comments; The 8540 is connected to the 8002A via 

an RS-232-C cable. The cable connects 
to jack J1 02 (DTE) on the 8540 rear pane! 
and jack J101 on the 8002A rear panel. 
The MODE SELECT switch on the 8540 
should be set to CNTL (L), and the 
REMOTE BAUD switch to 2400. On the 
8002A System Communication board, 
verify that the J1 jumper is in the lower 
position, and that the P0RT1 baud rate is 
set to 2400. 

Each system must have its own system 
terminal. 

The SEND command does not issue a 
prompt. 



PROGRAM EXECUTION 

Selecting the Target Processor 



Description; 

Procedure; 
Parameters; 

Comments; 



This procedure selects the proper emula- 
tor control software for the micropro- 
cessor you are programming. 

> sel microprocessor 

microprocessor — The OS/40 name of 
the target processor See the Emulator 
Specifics section of this manual for the 
OS/40 name of your microprocessor. 

OS/40 automatically performs several 
commands internally to initialize the 
emulator when you select the target 



Example: 



Selecting the Emulation Mode 

Description; This procedure selects the emulation 

mode in which the the system operates. 

Procedure; > em mode 

Parameters; mode — 0, 1, or 2. 

Mode is system mode. Execution in this 
mode uses program memory, 8540 
system I/O (through SVCs), and the 
emulator clock. The system is placed in 
emulation mode whenever the target 
processor is selected. 

Mode 1 is partial emulation mode. 
Execution in this mode uses program 
memory and/or prototype memory (de- 
pending on the memory map assign- 
ments), SVCs and/or prototype I/O, and 
the prototype's clock. 

Mode 2 is full emulation mode. Execution 
in this mode uses the prototype's 
memory, I/O, and clock, and may also 
use SVCs. 

Comments; The emulation mode is set to mode 

when you enter the SEL command. When 
executing programs in emulation modes 
1 and 2, your prototype must be 
connected to the system via the prototype 
control probe. 

Example; > em 1 

This example selects emulation mode 1 
(partial emulation mode). 

See also: • Selecting the target processor 



processor. Refer to the discussion of the 

SEL command in the Command Dictionary Description: 

section of this manual for further 

information. 

> sel 8085 Procedure: 

This command line selects the 8085A Parameters: 

emulator on the 8540. (The command 
also selects 8080A/8085A assembler 
and compiler software on the 8560, if you 
are in TERM mode.) 



Executina the Proaram 



This procedure begins program execution 
at the specified address. The program 
must already reside in memory. 

> g addr 

addr — The address of the next instruc- 
tion to be executed. If this parameter is 
omitted, execution continues at the 
address in the emulator's program 
counter. 
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Program Execution 



Example: > g 300 

This example starts program execution at 
address 300. 

See also: • Downloading a program from the 

8560 

• Downloading a program from the host 
computer 

• Downloading a program from the 
8550 

• Downloading a program from the 
8002A 



Displaying the Emulator Registers 

Description: This procedure displays the contents of 

the emulator registers. 



Procedure: 



Comments: 



Example: 



> ds 

For more information on the DS com- 
mand, seethe Emulator Specifics supple- 
ment for your microprocessor. 

> sel 8085 



> ds 



PC=0000 SP=0000 F=00 A=00 B=00 C=00 D=00 E=00 H=00 L=00 
SOD=0 SID=0 17=0 16=0 15=0 IE=0 M7=l M6=l M5=l 



Example: 

See also: 

Creating 

Description: 

Procedure: 
Parameters: 

Comments: 
Example: 



> s A=0E1 B=00 



This example sets the emulator registers 
A and B to El and 00, respectively. 

• Displaying the emulator registers 



See also: 



and Defining a Symbol 

This procedure adds a symbol to the 
symbol table and assigns it a value. 

> adds symbol=value 

symbol-The name of the symbol that you 
are creating. 

value — The value of the new symbol. 

You can enter more than one symbol 
definition on the same line. If a symbol 
represents a scalar (not an address), 
precede it with a -S. 

> adds start=100 -s tablesize=50t 

This example defines two symbols: start 
and tablesize with the values 100 
(hexadecimal) and 50 (decimal) respec- 
tively. 

• Downloading symbols from the 8560 



See also: 



Setting the emulator registers 



Setting the Emulator Registers 

Description: This procedure changes values in indi- 

vidual emulator registers. 

Procedure: >sr1=value1 r2=value2... 

Parameters: r1 — The name of an emulator register 

you want to set. 

valuel — The value you want to store in 
the register. 

r2 — The name of another emulator 
register you want to set. 

value2 — The value you want to store in 
the register. 



Creating a Virtual Memory Map 

Description: This procedure allows your program to 

access a block of memory locations at 
virtual addresses rather than at their 
actual physical addresses in program 
memory. This procedure is useful if your 
program accesses addresses beyond the 
limits of physical program memory. 

NOTE 

If you are using the Memory Allocation Controller 
(MAC) option or the 8086/8088 emulator, the AL 
command has a different syntax and use, so do not 
use this procedure. Refer to the Emulation section of 
this manual for an explanation of the MAC option. 



Procedure: 



> al actual blocks virtual 



(^ 
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Parameters: 



Example: 



actual — The physical address of the first 
memory location that you want to 
allocate to a different area. 

blocks — The number of 4K-byte blocks to 
be reallocated. 

virtual — The address that your program 
uses to refer to the beginning of the 
reallocated memory area. The addresses 
actual and virtual should be multiples of 
1000H. 

> al 2000 3 OAOOO 



This example makes the three 4K-byte 
blocks of memory starting at location 
2000 appear to be addressable starting at 
location AOOO. See Fig. 2-3. 

Logging Commands to the Line Printer 

Description: This procedure sends a copy of your 

terminal Input/output to the line printer. 

Procedure: > log LPT 

Comments: This command line sends all terminal 

input/output to both the terminal and the 
line orinter 



0000 



2000 



4FFF 



7FFF (32K) 

AOOO 
CFFF 



FFFF {64K) 



Physical address 
(Actually located here) 



Virtual address 
(Appears to be 
located here) 



Example: 



> log LPT 



(OS/40 commands) 



(Log CONG turns off the display 
to the line printer.) 



PROGRAM DEBUGGING 

Turning Symbolic Output On and Off 



Description: 



Procedure: 



Comments: 



This procedure turns symbolic display on 
or off. 

> symd on 

or 



See also: 



This command only affects the way in 
which commands like TRA and Dl display 
their output. If SYMD is on, symbols are 
substituted for address. You can still use 
symbols in expressions and use com- 
mands like SYMB and ADDS even if 
SYMD is off. For information regarding 
symbolic debug, refer to the Emulation 
section of this manual. 

• Tracing all of the program 

• Executing the program 



Tracing All of the Program 

Description: This procedure displays each instruction 

as it is executed. Tracing continues until 
the end of the program is reached or until 
a break occurs. 



Procedure: 



Parameters: 



> tra al 



Fig. 2-3. Virtual memory map assignments. 



^ g sin 

strt — The memory address at which 
program execution is to begin. If this 
parameter is omitted, execution begins at 
the transfer address of the program. 



2-10 



Operating Procedures — 8540 System Users 



Program Debugging 



Example. The example in Display 2-1 loads PR0G1 

from the 8560 and displays each 
instruction as it is executed. 

See also: • Tracing part of the program 

• Tracing program branches 

Tracing Part of the Program 

Description: This procedure displays the trace of a 

specified portion of the program. Instruc- 
tions outside the specified range are not 
included in the display. 

Procedure: > tra off 

> tra all loadd hiadd 

> g strt 

Parameters: loadd — The lowest address to be traced. 

hiadd — The highest address to be traced. 

strt — The memory address at which 
program execution is to begin. 



Comments: The first command line (TRA OFF) 

cancels any previous trace selections. 
TRA OFF may be omitted if no other trace 
selections have been entered. 

Example: See Display 2-2, 

See also: • Tracing all of the program 

• Tracing program branches 



Tracing Program Branches 

Description: This procedure traces only those instruc- 

tions that change the normal execution 
flow of the program (branches, subrou- 
tine calls, etc.). 

> tra jmp 

> g strt 

strt — The memory address at which 
program execution is to begin. 



Procedure: 



Parameters: 



> lo <PR0G1 
















> tra all 
















> g 100 


MNEM 


OPER 


SP 


F 


A B C D E H L 


IM 


SOD 


LOG INST 


000100 210005 


LXI 


H,0500 


0000 


04 


OF 01 00 00 00 05 00 


07 





000103 0605 


MVI 


B,05 


0000 


04 


OF 05 00 00 00 05 00 


07 





000105 AF 


XRA 


A 


0000 


44 


00 05 00 00 00 05 00 


07 





000106 86 


ADD 


M 


0000 


00 


01 05 00 00 00 05 00 


07 





000107 23 


INX 


H 


0000 


00 


01 05 00 00 00 05 01 


07 






Display 2-1. 



> tra 


off 
















> tra 


all 103 106 














> g 100 
















LOG 


INST 


MNEM 


OPER 


SP 


F 


A B C D E H L 


IM 


SOD 


000103 


0605 


MVI 


8,05 


0000 


04 


OF 05 00 00 00 05 00 


07 





000105 


AF 


XRA 


A 


0000 


44 


00 05 00 00 00 05 00 


07 





000106 


86 


ADD 


M 


0000 


00 


01 05 00 00 00 05 00 


07 





000106 


86 


ADD 


M 


0000 


04 


03 04 00 00 00 05 01 


07 





000106 


86 


ADD 


M 


0000 


04 


OF 01 00 00 00 05 04 


07 






Display 2-2. 



(ni 
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Example: The example in Display 2-3 loads PR0G1 

from the 8560 and executes it while 
iraciny all branch insiructions. 

See also: • Tracing all of the program 

• Tracing part of the program 

Stepping Through the Program 

Description; This procedure stops program execution 

after each trace line is displayed. To 
execute the next instruction, enter the G 
command. 

Procedure: > tra -s all 

> g strt 

Parameters: strt — The memory address at which 

program execution is to begin. 

Example: The example in Display 2-4 loads and 

executes PR0G1, stopping after each 
instruction. 



See also: 



Tracing all of the program 
Tracing part of the program 






r<iol#rt<-\in+ 



Procedure: 
Parameters: 



This procedure sets a program breakpoint. 
The breakpoint stops execution if the 
specified memory address is accessed for 
an instruction fetch or for any other 
memory read or write. For most emulators, 
up to two breakpoints may be specified at 
a time. 



> bk n address 

n— The number of the breakpoint. 1 or 2 
for most emulators. 

address — The memory address where 
program execution is to be interrupted. 



> lo <PR0G1 










> tra jmp 










> g 100 










LOG INST 


MNEM 


OPER 


SP 


F 


000109 020601 


JNZ 


0106 


0000 


10 


000109 C20601 


JNZ 


0106 


0000 


14 


000109 C20601 


JNZ 


0106 


0000 


10 


000109 C20601 


JNZ 


0106 


0000 


10 



A B C D E H L IM SOD 

01 04 00 00 00 05 01 07 

03 03 00 00 00 05 02 07 

06 02 00 00 00 05 03 07 

OA 01 00 00 00 05 04 07 



Display 2-3. 



> lo 


^PROGl 












> tra 


-s all 












> s 100 












LOG 


INST MNEM OPER 


SP 


F 


A B C D E H L 


IM 


SOD 


000100 


210005 LXI H,0500 


0000 


04 


OF 01 00 00 00 05 00 


07 





000100 


• BRE,\K TPo^CE~' 












' g 














LOG 


INST MNEM OPER 


SP 


F 


A B G D E H L 


IM 


SOD 


000103 


0605 MVI B,05 


0000 


04 


OF 05 00 00 00 05 00 


07 





000103 


^ BREAK TRACE" 













Display 2-4. 
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Debugging the Program in the Prototype 



F ample The example in Ji.^puiy ^ o lOaUS and 

executes PR0G1. Execution is inter- 
rupted when the program accesses 
address 504. 

See also: • Clearing a breakpoint 

• Displaying breakpoints 



Clearing a Breakpoint 

Description: This procedure cancels a breakpoint set 

by a previous BK command. 



Procedure: 
Parameters: 



Examples: 



See also: 



> bk n cir 

n — The number of the breakpoint that 
you want to cancel. For most emulators, 
valid entries for this parameter are 1, 2, 
or all. 

> bk 1 clr 

This example cancels breakpoint 1. 

■ bk all clr 

This command clears all breakpoints. 
• Setting a breakpoint 



Displaying Breakpoints 

Description: This procedure displays all breakpoints. 



Procedure: 



> bk 



Example: 

> bk 1 58 wt 

> bk 2 47F 

> bk_ 

BK 1 000058 WT (Breaks when your program 

writes at address 0058.) 

BK 2 00047F RD WT (Breaks when your program 
reads or writes at 047F.) 



See also: 



Setting a breakpoint 
Clearing a breakpoint 



Procedure: 



Parameters: 



Comments: 



Executing a Segment of Code Repeatedly 

Description: This procedure executes a segment of 

code repeatedly until you press CTRL-C. 

> bk 1 addr 

> g -r start 

addr — The address of the end of the 
segment of code that you want to repeat. 

start— The start address of the segment 
of code that you want to repeat. 

The segment of code is repeatedly 
executed until you enter a CTRL-C. Refer 
to the Command Dictionary of this 
manual for more information about the g 
-r command. 

> bk 1 8F10 

> g -r 100 

This example executes the code between 
addresses 1 00 and 8F1 repeatedly until 
you enter CTRL-C. 

• Executing the program 

• Tracing part of the program 



Example: 



See also: 



DEBUGGING THE PROGRAM IN 
THE PROTOTYPE 



Selecting SVCs 



Description: 



Procedure: 



This procedure enables the system 
service call (SVC) features. 



> SVC on 



> bk 1 504 










" £ 










LOG INST MNEM 


OPER 


SP 


F 


A B C D E H L IM SOD 


000106 86 ADD 


M 


0000 


04 


OF 01 00 00 00 05 04 07 


000106 <BREAK 


BK1> 






ADD M adds the bytes 
at address 504 into 
the accumulator. 



Display 2-5. 
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Comments: 



txampie: 



See also: 



When this feature is ON, OS/40 
executes SVCs in all emulation modes. If 
an I/O operation is found that can be 
translated into an SVC, it is treated as an 
SVC. Changing to emulation mode 1 or 2 
disables the SVC feature, but it can be 



enabled by performing this procedi 


irp 






> em 1 




> SVC on 





These command lines select emulation 
mode 1 and then enables the use of 
SVCs. 

• Selecting prototype I/O 

• Selectina the emulation mode 



Selecting Prototype I/O 

Description: 



This procedure turns the SVC feature 
OFF. When SVCs are OFF, all SVC 
invocations are treated as normal I/O 
instructions. If your program uses SVCs, 
do not execute it while the SVC feature is 
OFF unless the extraneous I/O instruc- 
tions are taken into consideration. 



• URW — Prototype memory, read and 
write access. 

• URO — Prototype memory, read-only 
access. 

Thg nrQnram /prototype designation ap- 
plies only in mode 1; the read-only 
designation applies only to program 
memory. 

NOTE 

Refer to the Emulator Specifics sect/on of tfiis 
manual for specific information about tire MAP 
command for your microprocessor. 



Example: 



> map 

0000-007F URW 
0080 -OOFF PRO 
0100-017F URW 
0180-01FF PRW 



F980-F9FF URW 



See also: 



• Creating a virtual memory map 

• Displaying the contents of memory 



NOTE 
Prototype I/O is available only in modes 1 and 2. 

Procedure: > svc off 

See also: • Selecting the emulation mode 



Displaying Memory Map Assignments 



Description: 



Procedure: 



Comments: 



This procedure displays the current 
memory map assignments. 

> map 



Each line of the display consists of a 
memory address range and one of the 
following parameters: 

• PRW — Program memory, read and 
write access. 

• PRO — Program memory, read-only 
access. 



USING THE TRIGGER TRACE 
ANALYZER 

NOTE 

To perform the procedures in this subsection, you 
must have the Trigger Trace Analyzer (TTA) option 
installed in your 8540 Integration Unit. TTA 
commands are available only after you have used the 
SEL command to select the emulator software. 



Breaking on a Designated Instruction 



Description: 



Procedure: 



This procedure uses the TTA to produce a 
breakpoint. The program continues to run 
until the designated instruction is exe- 
cuted. At that time, a break occurs and 
OS/40 returns control of the system to 
you. 

> eve -s 1 cir a=addr b=f 

> 9 strt 
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Parameters: 



Comments: 



Example: 



strt — The starting point for program 
execution. 

addr — The address of the designated 
instruction. 

The EVE command line establishes the 
conditions of event 1 . The CLR parameter 
erases any previous conditions design- 
ated for event 1 . The parameters a=addr 
and b=f set event 1 to trigger on any 
instruction fetch from addr. The -s 
parameter sets a breakpoint at event 1. 

> eve -s 1 clr a=30E8 b=f 



See also: 



In this example, a break occurs when an 
instruction fetch from 30E8 is performed. 



• Setting a breakpoint 

• Breaking on a specified pass through a 



loop 



Breaking on a Specified Pass Through 
a Loop 

Description: This procedure uses the TTA to stop 

execution of a program when the 
designated instruction is executed the 
specified number of times. 

Procedure: > eve 2 a=addr b=f 

> CPU -s 2 clr s=ev2 o=delav v=pass 

> gstrt 

Parameters: addr — The address of the designated 

instruction. 

pass — The number of times to execute 
the instruction before stopping: can be 
any expression that evaluates to a 
number in that range. 

Comments: The s=ev2 parameter counts the number 

of times that event 2 occurs. The o=delay 
parameter counts down from the value of 
pass and enables a breakpoint when it 
reaches 0. The v=pass parameter starts 
the counter at pass . 

If the instruction at address addr is 
executed fewer than pass times, no break 
occurs. In that case, the program 
continues either until termination, or 
until you type CTRL-C to regain control of 



Example: 



See also: 



the system. Refer to the Trigger Trace 
Analyzer Users Manual for more infor- 
mation. 

> eve 2 a-2F04 b=f 

> cou -s 2 clr s=ev2 o=delay v=3 



In this example, the instruction at 2F04 is 
executed 3 times before a breakpoint 
occurs. 

• Breaking on a designated instruction 



Breaking When Execution Proceeds 
Outside a Designated Range 



Description: 



Procedure: 



This procedure uses the TTA to stop 
execution of a program when the 
instruction to be executed lies outside the 
designated address range. 

> eve 1 -s clr an=loadd hiadd b=f 

> gstrt 



Parameters: strt — The starting point for program 

execution. 

loadd — The lowest address that can be 
executed without causing a break. 

hiadd — The highest address that can be 
executed without causing a break. 

Comments: The loadd address must be less than the 

hiadd address. Also, for meaningful 
results, the starting address of the 
program must lie between loadd and 
hiadd. 

Example: > eve l -s clr an=3100 4100 b=f 

In this example, program execution halts 
when the program proceeds outside of 
the range 3100—4100. 

See also: • Breaking when the program writes in 

a designated memory area 

Breaking When the Program Writes 
in a Designated Memory Area 

Description: This procedure uses the TTA to stop 

execution when an attempt is made to 
alter the contents of a designated 
memory area. 

Procedure: > eve -s 1 clr a=loadd hiadd b=m wt 

> gstrt 



(ffi 



2-15 



Using the Trigger Trace Analyzer 



Operating Procedures— 8540 System Users 



Parameters: strt — The starting point for program 

execution. 

loadd — The lowest address of the desig- 
nated memory area. 

hiadd — The highest address of the Comments' 

designated memory area. 

Comments: The EVE command line restricts the 

break to only those situations where a 
memory write (M WT) is attempted into a 
memory location inside the designated Example- 

range. The value of loadd must not 
exceed that of hiadd. 

You can also use the MAP command to 
designate an area of program memory as 
read-only. The first write to that area 
causes a break to occur. Refer to the 
Command Dictionary for information on 
the MAP command. 

Example: > eve -s l cir a=0C800 0E800 b=m wt 

This example halts program execution See also: 

when the program writes to memory in 
the range C800— E800. 

See also: • Breaking when execution proceeds 

outside a designated range 



quit — The address at which a break 
occurs. If you want execution to continue 
until the program Is completed, omit the 
EVE -S command line, as inthefollowing 
procedure. 

The EVE command lines describe the 
conditions that generate events 1 and 4. 
The DISP command line displays the 
contents of the Acquisition Memory on 
the system terminal. 

> eve 4 clr a=4F64 b=f 

> acq all for 1 eye aftertrig4 

> eve -s 1 elr a=OFFFF b=f 



g 4000 



> disp 

This example saves a record of the 255 
instruction cycles executed before the 
instruction at 4F64 is executed. 

• Recording instructions executed be- 
fore and after a designated instruction 

• Recording instructions executed after 
a designated instruction 



Saving an Execution Trace Record 
Without Interrupting the Program 

Description: This procedure uses the TTA to record 

and display 255 instruction cycles exe- 
cuted before a designated instruction. 
The program does not terminate when 
the designated instruction is executed, 
but proceeds until reaching the break- 
point address. 



Procedure: > eve 4 clr a=addr b-f 

> acq all for 1 eye aftertrig4 

> eve -s 1 clr a=quit b-f 

> g strt 

(Wait for program execution to terminate.) 

> disp 

Parameters: strt — The starting point for program 

execution. 



addr — The address of the instruction 
where you want to stop recording. 



Recording instructions Executed Before 
and After a Designated instruction 

Description: This procedure uses the TTA to record 

and display 127 instruction cycles exe- 
cuted before and 127 instruction cycles 
after the execution of a designated 
instruction. 

> eve 4 clr a=addr b=f 

> acq all for 1 27 eye aftertrig4 

> g strt 

strt — The starting point for program 
execution. 

addr — The address of the designated 
instruction. 

> eve 4 clr a=5A24 b=f 

> acq all for 127 eye aftertrig4 

This example saves a trace record of 1 27 
instruction cycles before and 127 in- 
struction cycles after the instruction at 
address 3A24. 



Procedure: 



Parameters: 



Example: 
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See also: • Saving an execution trace record 

without interrupting the program 

• Recording instructions executed after 
a designated instruction 



Recording Instructions Executed 
After a Designated Instruction 

Description: This procedure uses the TTA to record 

and display up to 255 instruction cycles 
that were executed after the designated 
instruction. 

Procedure: > eve 4 cir a=addr b=f 

> acq all for 255 eye aftertrig4 

> g strt ~~ 

Parameters: strt — The starting point for program 

execution. 

addr — The address of the designated 
instruction. 

Example: > eve 4 clr a=0B024 b=f 

> acq all for 255 eye aftertrig4 

This example saves a trace record of 255 
instruction cycles after the instruction 
executed from address B024. 

See also: • Saving an execution trace record 

without interrupting the program 

• Recording instructions executed be- 
fore and after an instruction 



Determining the Execution Time 
of a Program Segment 

Description: This procedure uses the TTA to calculate 

the time elapsed between the execution 
of two designated instructions. Program 
execution terminates when the second 
instruction is executed. Time can be 
calculated in any time units allowed by 
the COU command. 

Procedure: > eve 1 clr a=addr1 b=f 

> CPU 2 clr s=units o=arm g=seqh v=0 

> eve -s 2 clr a=addr2 b=f 

> i 

(Wait for program execution to terminate.) 

> ts -C 2 

Parameters: units — Any valid COU unit. Refer to the 

Emulation section of this manual for 
information about the COU command. 



Comments: 



Example: 



See also: 



addr1 — The address at which you want 
to start timing. 

addr2 — The address at which you want 
to stop timing. 

The CLR parameter of the EVE commands 
clears any previously set EVE conditions 
on triggers 1 and 2. The CLR parameter of 
the COU command clears any previously 
set conditions on counter 2. The s=units 
parameter sets the time units to count. 
The o=arm parameter causes the counter 
to count in ascending order. The v=0 
parameter starts the counter at 0. The 
g=seqh parameter tells the counter to 
start counting when trigger 1 occurs. The 
EVE 2 command line stops the counter 
when the instruction at the specified 
address is fetched. The TS command 
displays the value in the counter. 

> eve 1 clr a=3320 b=f 

> CPU 2 clr s=cyc o=arm g=seqh v=0 

> eve -s 2 clr a=5F40 b=f 



> ts -c 2 



This example displays the number of bus 
cycles that occurred during the execution 
of the program segment in the address 
range 3320— 5F4o" 

• Measuring the interval between probe 
events 

• Counting the occurrences of an event 



Counting the Occurrences of an Event 

Description: This procedure counts the number of 

times that a specified event occurs. 

Procedure: > eve 1 clr event 

> CPU 2 clr s=ev1 o=arm v=0 

> g 

(Wait for program execution to terminate.) 

> ts -c 2 

Parameters: event — The sequence of parameters that 

define the event. 



(fS 
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Comments; 



The parameter s=ev1 increments the 
counter when event 1 occurs. The o=arm 
'parameter tsMs the counter to count in 
ascending order. The v=0 parameter 
starts the counter at 0. After the program 
executes, the TS command line displays 



i_Adi I ipib. 



j- UXi ex 



=103C 



uuu 2 clr s— evl o-cirni v-0 



See also: 



> g 



> ts -c 2 

This procedure counts the number of 
times the program fetches an instruction 
from address 1030. 

• Breaking on a specified pass through a 
loop 

• Measuring the interval between probe 
events 



Measuring the Interval Between Probe 
Events 

Description: This procedure uses the TTA test clips to 

measure the time interval between two 
external events. The program terminates 
when the conditions of the second probe 
event are satisfied. 

Procedure: (Attach the TTA test clips to the desired 

signal lines in your prototype.) 

> eve 1 clr p=begn 

> CPU 2 clr s^units o=arm g=seqh v=0 

> eve -s 2 p=end 

> g strt 

Parameters: strt — The starting point for program 

execution. 

units — Any valid COU unit. Refer to the 
Emulation section of this manual for 
information about the COU command. 

begn — Eight characters representing the 
states of the eight test clips when the 
measurement is to begin. Each character 
can be (logic low), 1 (logic high), or X 
(don't care). If the first character is "X", 
put a zero in front of it. 

end — Eight characters (0, 1, or X) 
representing the states of the eight test 
clips when measurement (and program 
execution) is to end. 



Comments: This procedure is similar to that used for 

determining the execution time of a 
r\rQnrarn Segment. Here however the 
conditions for starting and stopping the 
counter are defined in terms of the test 
clip values instead of the designated 

iiiOLiuiOLiv/ii it>Loiit>o. iinioi\JorvcJiiuyiwijin_i 

lines of the TTA test probe must be 
attached for the TTA to function properly. 

Example: (Attach the TTA test clips to the desired 

signal lines in your prototype.) 

> eve 1 clr p=Oxxxxxxxl 

> COU 2 clr s=cyc o=arm g=seqh v=o 

> eve -s 2 p=llllxxxx 

This example measures the number of 
bus cycles between the time probe clip 
goes high and the time clips 4-7 become 
high simultaneously. 

See also: ^ Breaking on a f^robe event 

• Determining the execution time of a 
program segment 



Breaking on a Probe Event 

Description: This procedure uses the TTA to stop 

program execution when the conditions 
of the probe event are satisfied. 

Procedure: (Attach the probe test clips to the desired 

signal lines in your prototype.) 

> eve -s 1 p=begn 

> g strt 

Parameters: begn — Eight characters representing the 

states of the eight test clips when the 
measurement is to begin. Each character 

vydii lie \J \i\j\ji\j lovv;, I ^iuvjio inyii/, \ji A 

(don't care). 

strt — The starting point for program 
execution. 



Comments: The EVE command line defines event 1 in 

terms of a probe test clip value. The clock 
and ground lines of the test clips must be 
attached for the TTA to function properly. 

Example: > eve -s i p=ixxxxxOi 

This example halts program execution 
when the and 7 clips go high and the 1 
clip goes low. 
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See also: 



Measuring the interval between probe 
events 



MEMORY MANIPULATION 

Displaying the Contents of Memory 

Description: This procedure displays the contents of a 

selected area of memory. 

Procedure: > d loadd hiadd 

Parameters: loadd — The lower limit of the memory 

area to be displayed. 

hiadd — The upper limit of the memory 
area to be displayed. 

Example: In Display 2-6, the system terminal 

displays 16-byte data blocks from pro- 
gram or prototype memory. The display 
starts with memory address 0000 and 
continues to 002F. 

See also: • Changing the contents of a section of 

memory 

• Initializing a block of memory 



Changing the Contents of a 
Section of Memory 

Description: 



Procedure: 
Parameters: 



Example: 



See also: 



This procedure modifies consecutive 
memory locations. 

> p addr hexstring 

addr — The starting address of the data in 
program or prototype memory that you 
want to change. 

hexstring — A sequence of hexadecimal 
digits. The hexstring directly replaces the 
values in memory starting at the desig- 
nated address on a byte-by-byte basis. 
Each pair of digits represents one byte; 
thus the string must contain an even 
number of digits. For word-oriented 
microprocessors, the number of digits in 
the string must be divisible by 4. 

In Display 2-7, the contents of memory 
locations 400 through 40C are replaced 
with the specified hexadecimal string. 

• Displaying the contents of memory 

• Initializing a block of memory 



> d 3F 

0123456789ABCDEF 

000000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 21 

000010 00 05 06 05 AF 86 23 05 C2 06 01 D3 F7 00 00 00 #. 

000020 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 



Display 2-6. 



> d_ 


400 
































0123456789 
000400 00 00 00 00 00 00 00 00 00 00 

> p 400 00050605AF862305C20601D3F7 


A 
00 


B 
00 


C 
00 


D 
00 


E 
00 


F 
00 




> d_ 


400 

































000400 00 


1 
05 


2 
06 


3 
05 


4 

AF 


5 
86 


6 
23 


7 
05 


8 
C2 


9 
06 


A 

01 


B 
D3 


C 
F7 


D 
00 


E 
00 


F 
00 





Display 2-7. 



(a) 
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Initializing a Block of Memory 

Description: This procedure initializes memory loca- 

tions with a specified value. 



See also: 



Procedure: 
Parameters: 



Example: 



See also: 



> f loadd hiadd hexstring 

loadd — The lowest memory address to be 
initialized. 

hiadd — The highest memory address to 
be initialized. Must be greater than or 
equal to that of loadd . 

hexstring — The value that is to fill the 
designated memory area. If the target 
processor is word-oriented, this string 
must contain a multiple of 4 hexadecimal 
digits. Otherwise, an even number of 
digits are required. 

> f OFF 0000 



This command line fills memory locations 
0000-OOFF with the value 0. 

• Displaying the contents of memory 

• Changing the contents of a section of 
memory 



Breaking When the Program Writes 
in a Designated Memory Block 

Description: This procedure causes program execution 

to halt when the program attempts to 
write to a specified block of program 
memory. 

Procedure: > map pro loadd hiadd 

Parameters: loadd — The starting address of the 

memory range. 

hisdd The ending address of the memor^ 
range. 

Comments: The value of loadd should be less than 

that of hiadd. More than one range of 
addresses can be specified on the MAP 
command line. 

Example: > lo <progi 

> map pro 3A00 4FFF 

> g 100 

If during execution, progi attempts to 
write into a memory location within the 
range 3A00-4FFF, a break is generated. 



Breaking when the program writes in 
a designated memory area 



Disassembling the Contents of Memory 



uescripiiuii; 

Procedure: 
Parameters: 



This procedure translates the object code 
in the specified address range to its 
corresponding mnemonics and operands, 
and displays this information. 

> di loadd hiadd 

loadd — The memory address where 
disassembly is to begin. 

hiadd — The memory address where 
disassembly is to stop. 



Example: 



> di 100 lOE 


MNEM 




LOG 


INST 


OPER 


000100 


210005 


LXI 


H,0500 


000105 


0605 


MVI 


B,0& 


000105 


AF 


XRA 


A 


000106 


86 


ADD 


M 


000107 


23 


INX 


H 


000108 


05 


DCR 


B 


000109 


C20601 


JNZ 


0106 


OOOIOC 


D3F7 


OUT 


F7 


OOOIOE 


00 


NOP 





See also: 



The contents of memory locations 01 OO- 
OIOE are translated into mnemonics and 
operands and are displayed on the 
system terminal. 

• Displaying the contents of memory 

• Changing the contents of a section of 
memory 



SYSTEM I/O 

Displaying the Current Channel 
Assignments 

Description: This procedure displays ilie curreni I/O 

channel assignments. 

Procedure: > stat 

Comments: This command displays the following 

information: 

• The OS/40 name of the currently 
selected target processor. 

• The present assignments of channels 
0-7. 
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Example: 



See also: 



> Stat 
8085 is the selected processor 

Channel 6 is assigned to LPT 

• Assigning a channel 

• Closing a channel 



Example: 



See also: 



> as 3 tablel 5 LPT 

This example assignsthe8560file tablel 
to channel 3 and the line printer to 
channel 5. 

• Displaying the channel assignments 

• Closing a channel 



Assigning a Channel 

Description: 



This procedure associates a physical 
device or file with an I/O channel 
number. 



Procedure: > as n filespec 

Parameters: n— A logical I/O channel number. This 

number must be between and 7, 
inclusive. 

filespec — The device or 8560 file to be 
assigned to the channel number. 

Comments: I/O channels allow your programs to 

read or write to files or devices via service 
calls (SVCs). 



Closing a Channel 

Description: This procedure disconnects a file or 

device from an I/O channel previously 
opened with the AS command. 

Procedure: > cl n 

Parameters: n — The number of the I/O channel 

number that you want to close. This 
number must be between and 7, 
inclusive. 

Example: > cl 4 

This command line disconnects channel 
4 from the file or device to which it was 
assigned. 

See also: • Assigning a channel 

• Displaying the channel assignments 



(a) 
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INTRODUCTION 

This Commanri Dictinnary desnrihfis mnst OS/40 com- 
mands. The Command Index on the preceding page lists all 
commands described in this section according to their 
functions. The "Commands" subsection lists the commands 

alnhahotir-allv/ 



SYNTAX 



sample [-m] filel [file2] 



tPA~| I address I 
PB J (string /... 



3939-9A 



MP. J-1. bampie syntax diock. 



I his section is divided into the following subsections: 

• Other System Commands. Tells where to look for 
documentation of subsystem commands. 

• Command Syntax. Describes the notation conventions 
used in syntax blocks; command lines; and legal address 
expressions. 

• Special Keys. Describes the special function keys that 
the operating system recognizes. 

« Commands. Describes commands in detail. Each 
command description consists of the following parts: a 
syntax block, parameter definitions, an explanation of 
the function and use of the command, and one or more 
examples. 



OTHER SYSTEM COMMANDS 

Commands that invoke or use major subsystems are fully 
documented in other manuals, and are not described in this 
Command Dictionary. The following list shows the 
manuals that fully describe each subsystem command. 

• PROM Programmer commands (CPR, PSTAT, PTYPE, 
RPR, WPR) — PROM Programmer Specifics supplement 

• TTA commands (ACQ, AD, BRE, BUS, CONS, COU, CTR, 
DATA, DISP, EVE, PRO, QUA, TCLR, TS)— Trigger Trace 
Analyzer Users Manual 



COMMAND SYNTAX 

Each command description includes a syntax block that 
illustrates the format for a command. This subsection 
describes the notation conventions used in the syntax 
blocks; command line format, strings, and legal address 
expressions. 

Notation Conventions 

The syntax block for each command illustrates the 
command entry: the command name, whether or not each 
part of the command entry must be included, and the order 
in which to enter parts of the command entry. Figure 3-1 
illustrates a sample syntax block. 



This figure illustrates a syntax block for a fictional operating 
system command: sample is the command name; -m is a 
command modifier; and filel, file2, PA, PB, address, and 
string are command parameters. The braces, brackets, and 
trailing dots are for syntactical representation only. 



Command Line 

A command line consists of one of more commands and/or 
string definitions separated by semicolons (;). The 
maximum length of a command line is 80 characters, 
including spaces and the terminating carriage return. 

If you enter a command line that contains more than 80 
characters, a command buffer overflow error will occur. 
The excess characters will be stored in the type-ahead 
buffer and used as the beginning of the next command line. 
You must type CTRL-U or CTRL-C to delete the excess 
characters before entering another command. (The long 
command line will not be executed.) 

Braces | | in a syntax block surround required parts of the 
command line. Brackets [ ] in a syntax block surround 
optional parts of the command line. When parts are 
stacked, you choose one part from the ones in the stack. 
Braces and brackets serve only to represent the syntax, and 
should not be entered as part of the command line. 

Boldface letters and other characters in the syntax block 
are required in the command line, and should be entered 
exactly as they appear in the syntax block. 

Three trailing dots in a syntax block show that the 
preceding element of the command line may be repeated as 
many times as needed, up to the maximum line length of 80 
characters. 

Underlined letters within a required parameter represent 
the acceptable short form of the parameter. 

For most parts of a command line, you may use either 
uppercase or lowercase letters. The exceptions are as 
follows: String names must appear as they did when 
created. Command names must be entered in lowercase if 
you are in TERM mode with an 8560. 
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Command Name 

A command name is a word that represents an operating 
system command. Every command must begin with a 
Command name. 



Delimiters 

A delimiter separates parts of the command from each 
other. Allowed delimiters are spaces, commas, or tabs, 
with one comma being equivalent to one or more spaces or 
tabs. 



Command Modifiers 

A command modifier (a special type of parameter) consists 
of a dash (-) followed by a letter. Figure 3-1 contains the 
command modifier -m. 

Multiple command modifiers (when used) can be strung 
together: -A -B -C can be entered as -ABC. A command 
modifier, if specified, can usually occur anywhere in the 
command line; its position in the line is not significant 
except in the following instance. 

When a dash modifier is used to modify a parameter 
instead of the command, the dash modifier must 
immediately precede the appropriate parameter. For 
example, in the command line SEA 100 -A HELLO the 
third parameter is -A HELLO, signifying the ASCII string 
"HELLO". 

Using a modifier affects only one invocation of a command. 

Certain commands may produce unexpected results if you 
specify command modifiers that are invalid or contradictory. 



Parameters 

Parameters specify how the command is executed. 

Parameters in boldface must be entered exactly as they 
appear in the syntax block, when used. 

Parameters which are not in boldface describe the type of 
parameter. Acceptable entries for parameter types are 
described in the PARAMETERS explanation for each 
command. 

Parameters may be required or optional, as described in the 
following paragraphs. 

Required Parameters. Required single parameters appear 
in the command line without braces or brackets. In Fig. 3- 1 , 
fllel is a required parameter. 

Optional Parameters. Optional parameters are enclosed 
in brackets [ ] in the syntax block. In Fig. 3-1, file2 is an 
optional parameter. 



Omitting Parameters. To omit an optional parameter, 
enter two commas in its place. For example, to omit file2 
from the command line, enter: 

> SAMPLE -M MYFILE,,PA 100 

Use three commas when you omit two consecutive 
parameters. For example, to omit file2, and PA or PB from 
the command line, enter: 

> SAMPLE -M MYFILE,,,100 

Do not enter commas to omit a command modifier or the 
final parameter(s) in a command line. For example, to omit 
-M from the command line, you can enter: 

> SAMPLE MYFILE YOURFILE PA 100 



Choice of Parameters. Parameters are stacked one above 
another when there is a choice between two or more 
parameters. If the parameters are stacked within braces { }, 
one of the parameters must be used. In Fig. 3-1, either 
address or string must be chosen. If the parameters are 
stacked within brackets [ ], the selection is optional. In Fig. 
3-1, you may select either PA or PB or neither. 

Repeated Parameters. When three dots follow a 
parameter (or a group of parameters enclosed in brackets 
or braces), the parameter may be repeated any number of 
times up to the end of the command line. In Fig. 3-1, the 
choice of address or string may be repeated as many times 
as the line length permits. 



Examples 

Here are some examples of how the fictitious SAMPLE 
command (shown in Fig. 3-1) could be used: 

> SAMPLE MYFILE,, /^some text"' 

> SAMPLE -M YFL MFL PB "txta"" 10 OF ^axtb" 

> SAMPLE -M HISFILE,,PB 80 90 OAO OBO 



Redirecting Standard Input and Output 

in general, the operating system commands take input 
from standard input and send output to standard output. 
The system terminal usually serves as both standard input 
and standard output. 

However, you can redirect command input and output. A 
left arrow (<) redirects input, so the command can read 
from a file or device other than the system terminal. A right 
arrow (>) redirects output, so the command can send 
results to a file or device other than the system terminal. 

The I/O redirection arrow can be inserted in a command 
line anywhere after the command name, and can be 
applied to any command. 
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Using more than one input arrow (<) or more than one 
output arrow (>) in one command entry causes an error. 

Examples of I/O Redirection. Execute the LO command, 
and have the LO command download from the 8560 file 
MYLOFILE, with the following command line: 

> lo <MYLOFILE 

Execute the LO command, and have the LO command load 
from the paper tape reader with the following command 
line: 

> LO <PPTR 

Disassemble address range 100-20A, and send the 
disassembly to the line printer with thefollowing command 
line: 

> DI 100 20A >LPT 




Using the wrong redirection symbol may cause your 
file to be overwritten. For example, if you wanted to 
load from file LOADFILE but mistakenly entered lo 
>LOADFILE. then the LO command would attempt to 
read the load module from the terminal (standard 
input) and would send its output to LOADFILE, 
overwriting the current contents. 



Multiple Commands 

You may enter more than one command on an 80- 
character line, if you separate the commands with 
semicolons. For example, the first four commands m 
Display 3-1 are equivalent to the last command: 



> 


BK 1 504 


RD 


















> 


BK 2 lOA 




















> 


TRA A LOOPST 


LOOPEND 














> 


G 100 




















> 


BK 1 504 


RD; 


BK 2 


lOA 


TRA 


A 


LOOPST 


LOOPEND 


G 


100 



Display 3-1 . 

The commands in a multiple-command line are executed in 
the order in which they're entered, not in parallel. 
Command errors occurring along the way will not stop 
subsequent commands from executing. 

If you suspend a command in a multiple-command line 
using CTRL-C, the subsequent commands are lost. 

If you enter a multiple-command line that is more than 80 
characters long, the system issues an error message and 
does not execute any of the command line. Also, if any 
string substitutions are done on the multiple-command 
line so as to expand the line beyond 80 characters, the 
system issues an error message and does not execute any 
of the remaining commands in the long line. 



Escape Character 

The backslash (\) is used to "escape from" or "turn off" any 
special significance of the character it precedes. For 
example, OS/40 recognizes the dollar sign ($) as the first 
character of a string specification. To include a special 
character in a command parameter, precede it with a 
backslash (for example, \$) to disable the special 
significance. 

A character preceded by a backslash is treated "as is". For 
example, the operating system recognizes MY\"FILE as 
MY"FILE, MYXFILE as MYFILE, and MYWFILE as MYXFILE. 

To include a single or double quote (' or ") within an ASCII 
string, precede It with a backslash. The operating system 
recognizes the string "I said,\"OK\"" as the string: "I said, 
"OK"". 

You can't turn off the special significance of a carriage 
return with the backslash. 



Strings 



You may assign names to strings of characters, and then 
refer to the strings by name You can use strings as part of a 
command line, or a string can be a sequence of commands. 

NOTE 

Strings are volatile and will be lost if the S540 is 
restarted or turned off If you wish to save strings in 
the permanent string storage area in EEPROM, use 
the PERMS TR command. 



Defining Strings 

A name Is assigned to a string by entering the string name, 
an equals sign, then the string. To define a string, use the 
syntax shown in Fig. 3-2. 



strlngname=[']string['] 



Fig. 3-2. Syntax for string definition. 



PARAMETERS 

stringname The name you want to assign to the string of 
characters. May include up to 8 letters or 
digits, and the first character must be a 
letter. Uppercase and lowercase letters are 
considered distinct. 
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String The value of the string you want to nanne. 

The value must be enclosed in single or 
double quotes if it contains a delimiter such 
as a comma or space, but the quotes are not 
part of the string value. The value of the 
string must be enclosed in single quotes if it 
contains a backslash, a double quote, or a 
dollar sign. 

In any of these cases, you may avoid using 
quotes if you "escape" the special character. 
For information on how to do this and on 
how to include single quotes within your 
string, refer to the "Escape Character" 
discussion in this section. 



Using Strings 

You may reference the string anywhere in a command line 
by entering a dollar sign ($) followed by the string name. 

A string name may be made of stringnames. A string name 
may also expand into a dash modifier. If a string name is 
referenced, but no string with that name has been defined, 
a null value will be substituted. 

String substitution is repeated until no more substitutions 
are possible. For example, if a = "ab" and c = "100" and 
abl 00 = "1 234", $$a$c first changes to $ab1 00 and finally 
to 1234. 

String substitutions are done sequentially, not in parallel. 
For example. In the following sequence of commands, the 
second value of string abc("efg") istheonethat Isfoundby 
the SEA command. 

> abc="xyz" 

> abc=''efg" ; SEA $abc 



Using Quotes in Strings 

Double quotes (") are used to enclose a string that contains 
delimiters such as commas or spaces. All characters within 
the double quotes are treated as a single unit. 

Single quotes (') are used to enclose a string of characters 
that are to be treated "as is", and the single quotes escape 
(turn off) the special significance of any characters within 
the single quotes, such as the backslash and dollar sign. 
For example, if string xyz equals 1 00, then the string "abc 
$xyz def" becomes abc 100 def. However, the string 'abc 
$xyz def remains abc $xyz def. 



Examples 

Define strings REGSET, RANGE1, and RANGE2 with the 
following command lines: 

> REGSET=^'S Rl-0 RZ=2 R5=3" 

> RANGE1=''1000, 1300^^ 

> RANGE2=^^2010, 3000^^ 

Enter the string REGSET (equivalent to entering the S 
command) with the following command line: 

> IREGSET 

Disassemble address range 1 000-1 300 with the following 
command line: 

> PI IRANGEl 

Fill address range 2010-3000 with zeros with the 
following command line: 

> F IRANGEE 00 



Legal Address Expressions 

Any address parameter in a command line can be 
represented by an expression: a formula that contains 
numbers, register names, symbols, and memory space 
designators, related by the operators + and -. An expression 
must not contain any spaces. 

The following paragraphs describe each of these 
expression elements. 

Numbers. Each number Is suffixed with the standard 
character that selects its radix: 

H hexadecimal (default if no suffix is specified) 

T decimal 

Q or octal 

Y binary 

A hexadecimal number cannot begin with a letter. For 
example, the hexadecimal number A must be entered as 
OA. 

NOTE 

Do not specify a negative value for an address 
parameter. Negative addresses may produce unex- 
pected results. 
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NOTE 
Care must be taken if the expression parameter 

htaninc <A/ith o ry^irtim r-irtr> I* i./i/ZA^ «« .^o .W^^^W « ^^r,U 
^^^t, 1^ mv it.1 I u 1 1 III fKM^ Ajiyr I. n will ayo i>(yrio/uc7r c\j a uaoi i 

modifier unless you precede it with a zero. For 
example, 0-BIAS. 

Don't-Cares. An "X" within an expression can signify a 
"don't-care" value. Don't-care values are not allowed in 
decimal expressions (radix selector T); an error will be 
returned if you try to do so. 

An expression beginning with a don't-care X will be 
mistaken for a program symbol. Precede the X with a zero to 
begin an expression with a don't-care. 

Don't-care values are used mainly In Trigger Trace 
Analyzer commands. 

Register Names. Register names are used In expressions 
to represent the contents of the emulator registers. For 
example, the command CALC A+B displays the sum of the 
numbers In registers A and B. Refer to your Emulator 
Specifics supplement for the register names of your 
emulator. 

Operators. The two operators + and - are used In 
expressions to represent addition (+) and subtraction (-). 

Symbols. Expressions may also Include symbols. Symbols 
are names that represent values in your program. For 
example, two types of values that may be represented by 
symbols are addresses (unsigned numeric values), and 
scaiars (signed numeric values). The primary source of 
symbols is your assembly language program. After you 
assemble and link your program, the load file contains the 
symbols from your source code, and you can use the 
SYMLO or COM command to download the symbols and 
their values Into the symbol table In system memory. 

A secondary source of symbols Is the ADDS command, 
which adds symbols and their values to the symbol table. 

You can use the S command to assign a new value to an 
existing symbol. 

A symbol consists of one or more characters beginning 
with a letter and containing only letters, digits, periods, 
underscores, or dollar signs. ADDS and REMS Issue an 
error message If the symbol has more than 16 characters. 
Elsewhere, any characters after the 16th are Ignored. 

Symbols may be entered In command line expressions in 
either of their two forms: as "symbol" or "symbolspec". 
When "symbol" Is entered in the command line It Is simply 
the name of the symbol. A "symbolspec" Is either: the 
name of the section In which the symbol Is found, followed 
by a colon and then the symbol; or, simply the symbol. The 
term "symbolspec" In a syntax block stands for either. For 



example, If the symbol ELECTION, representing an 
address, appears In the label field of the program section 
CAMPAIGN, then ELECTION is the "symbol" and either 
CAMPAIGN:ELECTION or just ELECTION is the "symbolspec". 
Since scalars are not considered to be assigned to a particular 
section, the "symbolspec" for scalar symbols should not 
Include a section name 

Refer to your Assembler Users Manual for more details 
about symbols. 

Memory Space Designators. A number may be prefixed 
with a memory space designator, which Is a pair of letters, 
followed by a colon. For example, in the Z8001/Z8002 
emulator, the term SC: 1 000 specifies address 1 000 in the 
System Code memory space. Refer to the Emulator 
Specifics section of this manual to find out If your emulator 
uses memory space designators. 

Examples. The following expressions are legal: 


OFF 

VV+5 

X+Y-Z 

SC: 1000 

0AH+5T-7Q 

JUMPSTART 

FH (Unacceptable as a hexadecimal number: must 

not start with a letter. Acceptable as symbol FH; 

e.g., in ADDS command.) 

The following expressions are illegal: 

(W+5) (An expression may not contain paren- 

theses.) 

X*Y/Z (An expression may not contain asterisks 

or slashes.) 

OAH + 5T (An expression may not contain spaces ) 



SPECIAL KEYS 

The following special function keys and control characters 
are recognized by the operating system: 

• CTRL-C — Interrupts command or program execution 

• CTRL-Q — continues display after CTRL-S has been used 

• CTRL-R — displays all text in type-ahead buffer 

• CTRL-S— halts display 

• CTRL-U — discards all text in type-ahead buffer 

• CTRL-Z— end of file 

• BACKSPACE— deletes character 

• RUBOUT— deletes character 

To enter a control character (CTRL-x), hold down the CTRL 
key while you press the appropriate key. 
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CTRL-C 

One CTRL-C alerts the system to accept an additional 
command. Two CTRL-Cs in a row suspend all suspendable 
commands. 

Entering CTRL-C can cause one of the following effects: 

• One CTRL-C during command line entry deletes the 
contents of the type-ahead buffer, and displays a single 
or double prompt (> or >>) on the following line. A double 
prompt will be displayed only if one or more commands 
are currently running. The system then waits for you to 
enter another command line. 

• One CTRL-C during command execution causes a 
single or double prompt (> or >>) to be displayed and 
allows you to enter an additional command (usually an A 
command to abort the command already executing). Any 
active command continues to execute until it needs to 
access the terminal. 

• One CTRL-C while your program is running suspends 
the program and displays a trace line indicating where 
the break occurred. To resume program execution, use 
the G command. 

• Two CTRL-Cs during command execution cause all 
suspendable commands to be suspended. To abort a 
process after suspending, use the A command. To 
continue execution after suspending, use the CO 
command. 

If you enter CTRL-C while a multi-command line is 
executing, all commands after the one currently executing 
are lost. 

CTRL-C does not send a visible character to standard 
output. 

If the 8540 is in TERM mode with an 8560, CTRL-C sus- 
pends your program, if any, and aborts any commands that 
are executing. 



CTRL-R sends the characters AR to standard output. 



CTRL-S 

CTRL-S suspends the console display. Enter any character 
to continue the display. CTRL-Q is the only character that 
will resume the display without also being used as input. 
All other characters are used as input in addition to 
resuming the display. You may halt and continue the 
console display as many times as you desire. 

CTRL-S does not send a visible character to standard 
output. 



CTRL-U 

CTRL-U causes all characters in the type-ahead buffer to be 
discarded. If you have typed ahead more than one line, all 
lines will be discarded. Refer to the Learning Guide section 
of this manual for a description of the type-ahead buffer. 

CTRL-U sends the characters AU to standard output. 



CTRL-Z 

CTRL-Z is an end-of-file indication for ASCII input data. It 
does not send a visible character to the terminal. 



BACKSPACE 

The BACKSPACE key on a CRT terminal deletes the most 
recently typed character in the type-ahead buffer, erases it 
from the screen, and moves the cursor one space to the left. 
Refer to the Learning Guide section of this manual for a 
description of the type-ahead buffer. 



CTRL-Q 

CTRL-Q continues the display on standard output after it 
has been suspended by CTRL-S. Any character other than 
CTRL-Q is used as input and also resumes the display. 

CTRL-Q does not send a visible character to standard 
output. 

CTRL-R 

CTRL-R causes all characters in the'type-ahead buffer to be 
displayed on the terminal. If you have typed ahead more 
than one line, all lines typed in will be displayed. Refer to 
the Learning Guide section of this manual for a description 
of the type-ahead buffer. 



RUBOUT 

The RUBOUT key performs the same actions as the 
BACKSPACE key. 



COMMAND MEMORY AREAS 

Two commands can execute concurrently iftheydonotrun 
in the same memory area. The OS/40 commands reside in 
two areas of memory. Six of the commands (A, CO, G, LO, 
SUSP, and X) are resident; the rest share the system 
memory overlay area. If you press CTRL-C once while one 
of the commands in the system memory overlay area is 
executing, the system prompt becomes a double right 
arrow (>>), and you can execute one of the resident 
commands. 
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SYNTAX 



connmand 

-a 

-u 



comnnand 



-a 



PARAMETERS 

The name of a command: any command 
listed in this Command Dictionary. 

All active commands or programs. 

-u The program executing in program memory. 

EXPLANATION 

The A command terminates execution of the specified 
command or program. The A command also closes all 
channels assigned to the aborted process. After execution 
of the specified process is aborted, control returns to the 
operating system, and you may enter commands as usual. 

You can only enter the A command when the system 
prompt is displayed. When previously entered commands 
or programs are running, you must first return control to 
the keyboard with CTRL-C. 

Entering one CTRL-C alerts the system to accept another 
command; commands currently running are not disturbed 
until they need access to the terminal. Entering two 
successive CTRL-Cs alerts the system to accept another 
command, and suspends all currently running commands 
or programs. Refer to the "Special Keys" heading in this 
section for details on the CTRL-C character. The system 
prompt will be displayed after you enter one or two CTRL- 
Cs. 

When the system prompt is displayed, you can enter the A 
command to terminate execution. The system then issues 
an "Error FE — Process aborted" message, along with the 
name nf the affentpri nnmmanri. 



To terminate a particular command, enter the A command 
with the name of the command to be terminated. To 
terminate all active processes, enter A -A. To close the 
channels of the program executing in program memory, 
enter A -U. 



If you abort a displaying command, such as the D 
command, an extra line of text is displayed after the A 
command is invoked. 

The following commands may NOT be aborted or 
suspended: 

A G SUSP 

COM LO X 

CO SEL 

Refer to the SUSP command for information on 
suspending, rather than aborting, command execution. 

EXAMPLES 
Abort 3 Gommsrsd 

Start dumping a large listing on the line printer with the 
following command entry: 

> D OFFFF >LPT 

Enter CTRL-C to receive the system prompt, then enter the 
following command to abort execution of the D command: 

> A D 



Abort the User Program 

Run your program by entering the G command: 

> £ 

Enter CTRL-C to suspend your program. A trace line is 
displayed, then a BREAK message, then the system 
prompt. Enter the following command line to close the 
channels opened by your program: 

> A -U 



3-8 



(a) 



Command Dictionary — 8540 System Users 



ADDS 



Adds symbol to symbol table 





SYNTAX 




[sectionname;] addresssymb^value \ 


adds 


-s scalarsymb=value j ... 



NOTE 

Like other symbols in the symbol table, symbols 
created with the ADDS command reside in system 
memory, and will be lost when the 8540 is restarted 
or turned off. 



addresssymb 



sectionname 



scalarsymb 



value 



PARAMETERS 

Signifies that the following symbol 
represents a scalar value. 

A user-defined symbol to be used to 
represent the address. 

The name of the section with which 
addresssymbol is to be associated. This 
parameter is required if the symbol does 
not lie within the bounds of the section to 
which it is associated, or when a symbol 
is added to an absolute section. If 
sectionname is not indicated, the system 
will automatically associate the symbol 
with the section which contains it. 

A user-defined symbol to be used to 
represent a scalar value. The symbol may 
not contain a section name. 

An expression whose value is assigned to 
the symbol. 



EXPLANATION 

The ADDS command inserts a user-defined symbol, with 
its associated value, into the user symbol table. The symbol 
can then be used in place of the value in any command line 
during the debug session. 

When you reboot or SELect, symbolic debug automatically 
puts a dummy section entry called "NO. SECTION" in the 
symbol table. This section encompasses all of memory, and 
allows you to put address symbols in the symbol table using 
ADDS without doing a SYMLO. 

Refer to the Emulation section of this manual for an 
overview of symbolic debug. 

NOTE 

If you define an address symbol with the ADDS 
command, the address must lie within a currently 
defined section unless "sectionname:" is included in 
the command. Section definition information is 
provided in the load module. You cannot use the 
ADDS command to define a section. 



EXAMPLES 

Use a Symbol to Monitor a Memory 
Address 

Assuming that there is a section containing the address 
500H, enter the following command lineto create a symbol 
called COUNTER and assign it a value of 500H: 

> ADDS C0UNTER=500H 

Enter the following command line to define breakpoint 
number 1 , which suspends execution when a write is made 
to the address represented by COUNTER: 

> BK 1 COUNTER WT 



Use Symbols to Monitor a Loop 

Enter the following command line to create symbols 
LOOPST and LOOPEND, and assign them the values of the 
addresses of the beginning and ending of the loop: 

> ADDS L00PST=0106H L00PEND=0109H 

Enter the following command line to trace all the 
instructions within the loop as it executes: 

> TRA A LOOPST LOOPEND 



Add a Symbol Outside Existing Sections 

If you have only one section called "SECTIONA" in memory 
locations 100-200, and you attempt to add the symbol 
"SYMBOL" at location 300, as follows: 

> ADDS SYMB0L=300 

you will get this error message: 

Error 8D No section contains specified address 

Instead, use the section name, too: 

> ADDS SECTIONA :SYMB0L=300 
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SYNTAX 

al [actual] [blocks] [logical] 



PARAMETERS 

actual An expression representing the beginning 

address of the program memory region that 
you want to allocate to logical (virtual) 
addresses. Must be between and the 
highest address in existing program memory. 
Defaults to 0. 

blocks An expression representing the number of 

contiguous 4K-byte blocks of program 
memory you want to allocate. Must be 
between 1 and 1 OH. Defaults to the number 
of blocks from the actual memory address to 
the end of installed program memory. 

logical An expression representing the beginning 

address of the first logical (relocated) block. 
Must be between and FFFF. Defaults to the 
actual memory address. 

The Allocate command entered without parameters 
displays the memory allocation status. 



EXPLANATION 

NOTE 

There are two different versions oftheAL command. 
The version described here is supported by the 8540 
itself. The t\Aemory Allocation Controller (MAC) 
option also supports an AL command which has the 
syntax: 
al loaddr [hiaddr] 

The MAC version of the AL command is described in 
the Emulation section of this manual. 

Some emulators (e.g. the 8086/8088) support the 
MAC version of the AL command even though they 
do not use the MAC option. Refer to your Emulator 
Specifics supplement. 

NOTE 

You must have SELectedthe target processor before 
executing the AL command. The SEL command 
reinitializes logical address assignments to be the 
same as the physical addresses. 

The AL command allows your program to access a block of 
program memory at logical addresses instead of their 
physical addresses. 

If you only have 32K of program memory (addresses 
0000-7FFF), but your program accesses addresses in the 
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AL 



Allocates memory to logical address map 



range 8000-FFFF, you can use the AL command to 
temporarily reassign a section of program memoryfromthe 
0000-7FFF address range to the 8000-FFFF address 
range. 

Initial settings may be restored by entering the following 
command line; 



> AL 10 



NOTE 



The AL command affects only program memory, not 
prototype memory. IVlemory allocation fias no effect 
in emulation mode 2, and does not affect prototype 
memory locations in mode 1 . 

EXAMPLE 

Assume your program has a subroutine in the address 
range FOOO-FFFF, but you only have 32K of program 
memory (up to address 7FFF). Also assume your program 
does not use any addresses in the range 3000-3FFF. Enter 
the following command to allocate the unused memory to 
the needed memory: 



> AL 3000 1 OFOOO 



logical memory address 



1 4K-byte block 



actual memory address 



To display the memory allocation status, enter the AL 
command. See Display 3-2. 

Figure 3-3 shows how your memory map now looks. 



0000 












2FFF 
3000 

3FFF 
4000 






Used for logical memory 








7FFF 
8000 












No Memory 






EFFF 








FOOD 
FFFF 














This logical block 






of program memory 
physically resides 
at 3000-3FFF 






34'i7 r,> 



Fig. 3-3. AL command example. 



> AL 
Virtual 




Physical address 


0000-OFFF 


= 


OOOO-OFFF 


lOOO-lFFF 


= 


1000- IFFF 


2000-2FFF 


- 


2000-2FFF 


3000-3FFF 


- 


3000-3FFF 


4000-4FFF 


- 


4000-4FFF 


5000-5FFF 


- 


5000-5FFF 


6000-6FFF 


- 


6000-6FFF 


7000-7FFF 


- 


7000- 7FFF 


8000-8FFF 


= 


8000-8FFF 


9000-9FFF 


= 


9000-9FFF 


AOOO-AFFF 


= 


AOOO-AFFF 


BOOO-BFFF 


= 


BOOO-BFFF 


COOO-CFFF 


= 


COOO-CFFF 


DOOO-DFFF 


= 


DOOO-DFFF 


EOOO-EFFF 


= 


EOOO-EFFF 


FOOO-FFFF 




3000-3FFF -^ — When the program references addresses 

between FOOD and FFFF, the emulator will 
access physical memory at 3000 to 3FFF. 



Display 3-2. 
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SYNTAX 



as Ichannel filespec| 



PARAMETERS 

channel An I/O channel number between and 7. 

filespec The name of the file or device to be assigned 

to the channel number. 



To display the channel-to-device assignments and the 
emulator processor status, enter the STAT command. To 
disconnect a channe! from a device, use the CL command. 

The AS command creates a new file if the specified file 
does not exist. 

NOTE 

You must have SELected the target processor before 
executing the AS command. 

Your 8540 must be in TERM mode in order to assign 
files on the host. 



EXPLANATION 

The AS command assigns the specified device or host file to 
the specified I/O channel. Channel assignments allow 
your programs to read from or write to devices or files on 
the host, using service calls. Refer to the Service Calls 
section of this manual for further details. 

Channels are numbered throy^h 9. Channels 8 and 9 are 
initially assigned to the system for standard input and 
standard output, respectively. 

Console input (CONI) and console output (CONO) may be 
assigned to any number of channels at the same time. All 
other devices are limited to one channel assignment at a 
time. 

Table 3-1 lists the allowable system device names, their 
meanings, and the connector numbers to which the 
devices must be attached. 

Table 3-1 
System Devices 



Device 




Connector 


Name 


Meaning 


Number 


CONO 


Console output 


J104 


CONI 


Console input 


■J 1 04 


LPT 


Line printer 


J103 


PPTP 


Paper-tape punch 


J103 


PPTR 


Paper-tape reader 


J103 


REMI 


Remote input 


JIOI(DTE), J102(DCE) 


REMO 


Remote output 


JIOI(DTE), J102(DCE) 



The 8560 also has an AS command, which invokes 
the TNIX assembler. If your 8540 is operating in 
TERM mode with an 8560, the 8540 AS command 
must be preceded by the word "8540, " as in the fol- 
lowing examples. 

EXAMPLES 



Assign Channels 

Connect channel to the host file named DATAFILE and 
channel 1 to the local line printer (LPT) with the following 
command line: 

> 8540 as DATAFILE 1 LPT 



Enter the STAT command to display channel assignments 
and emulator status. See Display 3-3. 

Reassign Channel 

Here's an example of reassigning a channel that's already 
been assigned once. Try to assign channel 1 , which is al- 
ready assigned to the line printer, to the file OUTFILE with 
the following command line: 



> 8540 as 1 OUTFILE 

> AS: Error 18 



(Channel already open) 



An error occurs. You must disconnect the assigned channel 
from the line printer before you can connect that channel to 
another file or device. Enter the following command line to 



> 8540 as 1 OUTFILE 



Now enter the STAT command again. See Display 3-4. 
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AS 

Assigns channel to device or file 

BK 

Sets or displays breakpoint condition 



> Stat 

8085 is the selected processor 

User program was last loaded into program memory 

Channel is assigned to DATAFILE 
Channel 1 is assigned to LPT 



Display 3-3. 



> stat 

8085 is the selected processor 

User program was last loaded into program memory 

Channel is assigned to DATAFILE 
Channel 1 is assigned to OUTFILE 



Display 3-4. 



SYNTAX 



bk 

or 




rd 
bk[-c]|2) expressionLwt^ 



PARAMETERS 

1 Specifies breakpoint number 1. 

2 Specifies breakpoint number 2. 

all Specifies all currently defined breakpoints. 

cir Clears the specified breakpoint. 

■~c »_ontinues execution after each breakpoint 

occurs. If -C is not specified (default 
condition), the BK command stops execution 
after a breakpoint occurs. To resume 
program execution, enter the G command 
without parameters. 

expression An expression representing the address 
where program execution is to be inter- 
rupted. 

rd Designates that a breakpoint occurs when a 

memory read operation occurs at the 
specified address. Defaults to any access 
(read or write). 

wt Designates that a breakpoint occurs when a 

memory write operation occurs at the 
specified address. Defaults to any access 
(read or write). 

NOTE 

The syntax for the BK command may be different for 
some emulators. Refer to your Emulator Specifics 
supplement for details. 



When you enter the BK command without parameters, the 
currently set breakpoints are displayed. The breakpoint 
display will contain symbols if breakpoints are set at 
addresses of loaded symbols. 

EXPLANATION 

The BK (BreaKpoint) command sets a breakpoint that will 
suspend program execution when the specified address is 
read from or written to. Up to two breakpoints may be active 
at one time. 

When a breakpoint is encountered during execution, a 
trace line is displayed followed by the message "BKPT1 " or 
"BKPT2", depending on which breakpoint occurred. Some 
emulators offer additional features with the BK command, 
such as the ability to set up to 3 breakpoints concurrently. 
See the Emulator Specifics supplement for your emulator 
for details. 

If the optional RD/WT parameter is omitted, the breakpoint 
will occur whenever the address is read from or written to. 

To clear existing breakpoints, use the CLR parameter. 

NOTE 

You must have SELectedthe target processor before 
executing the BK command. 

If you set a breakpoint at an I/O instruction that 
invokes an SVC, the SVC executes before the break 
occurs. For some emulators, execution of the SVC 
may prevent the operating system from breaking at 
the desired instruction. 



EXAMPLES 

Set and Use a Breakpoint 

Display the currently set breakpoints with the following 
command line: 

> bk 

BK 1 CLR 

BK 2 CLR 
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No breakpoint has been set. To set a breakpoint that 
executes only if your program reads an instruction or other 
data from address 504, enter the following command line- 

> bk 1 504 rd 

Now select emulation modeO, download the 8560fileOBJ 
into program memory, and start execution at location 100 
with the command sequence shown in Display 3-5. 



assigns the symbol ENDLIST to address 504, and sets a 
breakpoint to occur at the symbol (address 504) during 



Clear any existing breakpoints with the following command 



> BK ALL CLR 



A breakpoint is encountered when the instruction at 
location 106 reads data from address 504. A trace line is 
displayed, followed by the BREAK message. 

To display the currently set breakpoints, enter the following 
command line: 



RD 



Set a Breakpoint Using a Symbol 

Assume that address 504 is the end of a data list which 
your program uses. The following sequence of commands 



> bk 
BK 


1 000504 


BK 


2 CLR 



Assign symbol ENDLIST to address 504 with the following 
command line: 

> ADDS ENDLIST=504 

Set a breakpoint to break on a read from symbol ENDLIST 
(address 504) with the following command line: 

> BK 1 ENDLIST RD 

With SYMD ON, enter the following command line to 
display the breakpoint conditions: 

> BK 

BK 1 ENDLIST RD 

BK 2 CLR 



> em 








> lo <OBJ 








> g 100 








LOG INST 


MNEM OPER 


SP FABCDEHL 


IM SOD 


000106 86 


ADD M 


0000 04 OF 01 00 00 00 05 04 


07 


000106 <BREAK 


BKPT1> 
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CALC 



Evaluates arithmetic expression 



SYNTAX 



calc [-radix] expression 



Calculate the sum of the hexadecimal numbers A, B, and C, 
but display the result in decimal with the following 
command line: 

> CALC -T OA+OB+OC 
33T 



PARAMETERS 

radix A letter that selects the number base (radix) 

for the result of the calculation. The 
allowable radix selector letters are: 

H hexadecimal (default value) 

T or D decimal (base 10) 

Q or octal (base 8) 

Y or B binary (base 2) 

expression Any valid expression as defined under the 
"Legal Address Expressions" heading earlier 
in this section. 



EXPLANATION 

The CALC command evaluates an arithmetic expression 
and displays the result on standard output (usually the 
system terminal). The result is displayed in the selected 
radix, as shown by suffix H, T, Q, or Y. A negative result is 
output in two's-complement notation, except for decimal 
numbers, where a minus sign is used instead. 

A hexadecimal number cannot begin with a letter. For 
example, the hexadecimal number A must be entered as 
OA. 



EXAMPLES 



Add Numbers 



Calculate the sum of the hexadecimal numbers A, B, and C 
and display the result in hexadecimal with the following 
command line: 

> CALC OA+OB+OC 
21H 



Add Contents of Registers 

Display the contents of the emulator registers with the DS 
command (the selected emulator is the 8085A). See 
Display 3-6. 

When a leading zero is omitted in an expression, the CALC 
command recognizes the character as a symbol. To 
calculate the sum of the contents of registers A, B, and C, 
enter: 



> CALC A+B+C 
14H 



(04+0F+01=14H) 



Subtract Numbers 

To subtract decimal number 6 from decimal number 5 and 
display the result in hexadecimal, enter: 

> CALC 5T-6T 
FFFFFFFFH 

Notice that the result is output in two's-complement 
notation. 

To subtract the decimal number 6 from decimal number 5 
and display the result in decimal, enter: 

> CALC -T 5T-6T 
-IT 

Notice that the negative result is displayed in decimal with 
a minus sign. 



> DS 

PC=0011 SP=5500 F=65 A=04 B=OF C=01 D=66 E=00 H-01 L=ll 

S0D=1 SID=0 17=1 16=1 15=1 IE=1 M7=0 M6=0 M5=0 



Display 3-6. 



(a) 
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SYNTAX 



cl channel 



PARAMETERS 

channs! An I/O ch3nn6! numbsr bBtwssn snd 7. 



EXPLANATION 

The CL comnnand disconnects the specified I/O channel(s) 
from the device or host file previously associated with the 
channel. 

To check the status of I/O channels and the files or devices 
associated with them, enter the STAT command. 

NOTE 

You must have SELectedthe target processor before 
executing the CL command. 

When you use the CL command, your 8540 must be 
in TERM mode in order to access files on the host. 

Refer to the AS command for information on assigning, 
rather than closing, channels 



EXAMPLE 

Display the current system status with the STAT command. 
See Display 3-7. 



> Stat 




8065 is the selected processor 




User prograiu was last loaded into program 


memory 


Channel is assigned to LPT 




Chaxunel 1 is assigned to MYFILE 





Display 3-7. 



Disconnect channels and 1 from LPT and MYFILE, 
respectively, with the following command line: 

> cl 1 

Display the system status again. See Display 3-8. 



> Stat 














8085 


is 


the 


selected 


processor 






User 


program 


was 


last 


loaded into 


program 


memory 



Display 3-8. 



M »<..-, ^U, 



vote timt no Ciiannei assignments are uispiayeu. 
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CLOCK 

Controls program clock 



clock 


on 
off 

_value_ 


SYNTAX 



PARAMETERS 

on Enables the 1 00-nnillisecond program clock. 

off Disables the 100-millisecond program clock. 

value A decimal number between and 65535. 

Sets the 100-millisecond program clock to 
the given value. 

When you enter the CLOCK command without parameters, 
the current value of the clock and the elapsed time are 
displayed. 



EXPLANATION 

The CLOCK command zeros, enables, or disables the 
program clock. When this clock is ON, it will be 
incremented every 100 milliseconds only during emulator 
program execution. The program clock defaults to OFF after 
system power-up or restart. 

While the clock is ON, the emulator runs approximately one 
percent slower than otherwise. 

The Trigger Trace Analyzer provides more precise and 
versatile timing features. This option Is described in the 
Emulation section of this manual. 

NOTE 

You must have SELectedthe target processor before 
executing the CLOCK command. 



EXAMPLES 

Display Current Clock Values 

Display the current clock counter and elapsed time by 
entering the CLOCK command without a parameter: 

> CLOCK 

78 
47 



Clock counter is 
Elapsed time is 



Time Execution of Program Segment 

Enter the following command to zero the program clock: 

> CLOCK 

Now enable the program clock with the following 
command: 

> CLOCK ON 

Start execution by entering the G command. See Display 
3-9. 

Display the program clock and elapsed time again: 

> CLOCK 

Clock counter is 64 
Elapsed time is 64 

The program took 6.4 seconds (6400 milliseconds) to 
execute the code between address 100 and the first 
breakpoint. Now resume program execution at the 
instruction following the breakpoint. See Display 3-10. 

Display the program clock again: 

> CLOCK 

Clock counter is 69 
Elapsed time is 5 

One-half second (500 milliseconds) elapsed before the 
second break. A total of 6.9 seconds of execution time have 
elapsed since program execution began at address 100. 



> G 100 




LOC INST MNEM OPER 


SP F A B C D E H L IM SOD 


000306 86 ADD M 


0000 04 OF 01 01 00 00 05 04 07 


000306 <BREAK BKPT1> 





Display 3-9. 



> G 




LOC INST MNEM OPER 


SP F A B C D E H L IM SOD 


0200 86 ADD M 


0000 04 IF 01 00 00 00 06 OA 07 


0200 <BREAK BKPT2> 





Display 3-10. 



(??■ 
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SYNTAX 



CO 



( command 1 



PARAMETERS 

command The name of a command: any command 
listed in this Command Dictionary or an 
allowed short form. 

-a Designates all suspended commands. 



EXPLANATION 

The CO (continue) command continues execution of a 
suspended command. Execution resumes at the point 
where the process was suspended. 

A command may be suspended in either of two ways: 

1 . by entering CTRL-C twice (suspends all processes), or 

2. by entering CTRL C once and then entering the SUSP 
command. 
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COM 



Sets up communications with host computer 



SYNTAX 



lp=promptl lt=delayl lm = parityl 

lf=tl leol = hexstringl lhs = offl Isub chl =ch2l/ch1 =ch21. 
lb = bytecountl 



t= 



PARAMETERS 

= Echo parameter. 

r Selects remote echoing of characters 

entered from the system terminal. (Host 
echoes character.) Default value. 

I Selects local echoing of characters entered 

from the system terminal. (8540 echoes 
character.) 

Linefeed parameter. 

o Specifies that the 8540 does not output a 

linefeed with a carriage return. (Host 
provides linefeed.) Default value. 

i Specifies that the 8540 outputs a linefeed 

with each carriage return. 

- Prompt parameter. Specifies the prompt 

sequence of the host computer communi- 
cating with the 8540. 

prompt Prompt sequence. The characters that the 

host computer outputs when it is ready to 
receive data. The prompt sequence consists 
of up to 32 hexadecimal digits, representing 
up to 16 ASCII characters. Defaults to no 
prompt sequence. 

Turnaround delay parameter. Specifies the 
preparation time required by the host 
computer between sending a message or 
prompt sequence to the 8540 and receiving 
a message from the 8540 during data 
transfers. 

delay Delay time. A two-digit hexadecimal number 

representing the delay time in 100-millisec- 
ond units. Defaults to 00. (For COM Version 
4.1 and later versions, the delay time is spec- 
ified in 10-millisecond units.) 

1= Parity parameter. Selects the parity option 

required by the host computer when it 
receives or sends data. 

parity Includes character transmission length and 

number of stop bits. Refer to a table of the 
Intersystem Communication section for the 



f= 



eol= 



hexstring 



hs=off 



sub 



possible values of this parameter and what 
those values represent. 

Error check parameter. 

Specifies that COM execution stops if a 
communication error (lost carrier, parity 
error, or framing error) occurs on the remote 
communication port. Default value. 

Ignores communication error and continues 
COM execution. 

Load Module Format parameter. This 
parameter specifies the message block 
format to be used in formatted uploads. If 
this parameter is omitted, blocks are 
transmitted in Extended Tekhex format. 

Specifies Standard Tekhex format. COM 
accepts message blocks in either Standard 
or Extended Tekhex format, regardless of 
the F parameter setting. 

End-of-line parameter. This parameter spec- 
ifies the character sequence used by the 
host to mark the end of a line of text, such as 
a host command or a Tekhex message block. 



A maximum of 32 hexadecimal digits 
representing a character string. Defaults to 
an ASCII carriage return (OD hexadecimal). 

Handshaking parameter. The parameter 
HS=OFF eliminates the ACK/NAK response 
from the protocol of a formatted transfer. In 
a download, COM normally responds with 
an ACK or NAK each time it receives a 
message block from the host. When 
handshaking is OFF, COM gives no response. 
However, checksums are still computed and 
checked, and if any are found to be incorrect, 
COM issues an error message when the 
transfer is complete. In an upload, COM 
expects no ACK or NAK response from the 
host. Checksum calculating is also turned 
OFF. 

Turning handshaking off has no effect on 
the P (prompt sequence) and T (turnaround 
delay) parameters. COM still looks for the 
host's prompt sequence (if any) and waits 
the indicated turnaround delay time (if any) 
before continuing. 

Substitution parameter. This parameter 
specifies one or more character substi- 
tutions to be performed by COM on ASCII 
data transmitted to or from the host. Each 
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substitution construct consists of a pair of 
character codes (represented as two-digit 
hexadecimal mimhers) separated by an 
equals sign. When the first character is 
received from the host, COM substitutes the 
second character. When the second char- 
acter is to be sent to the host COM 
substitutes the first. 

Multiple substitution constructs can be 
strung together, separated by slashes. For 
example, the parameter entry SUB 
aa=bb/cc=dd/ee=ff will cause the host 
character aa to be changed to bb; the host 
character cc to be changed to dd; and the 
host character ee to be changed to ff, when- 
ever COM receives the characters aa, cc, or 
ee from the host. 

ASCII character encoded as two hexadeci- 
mal digits. 

ASCII character encoded as two hexadeci- 
mal digits. 

Byte count parameter. Specifies the number 
of bytes of object code that COM will place 
in each data block during formatted uploads. 
(Each byte is encoded as two hexadecimal 
digits.) This parameter is supported only for 
COM Version 4.1 and later versions. This 
parameter is ignored if you specify F=T. 

A two-digit hexadecimal number in the range 
01-76. Defaults to 20 (32 decimal). Any num- 
ber outside the range 01-76 yields a byte 
count of 76 (1 18 decimal). 



Any or all of the COM parameters may be entered in the 
command line, in any order. If the same parameter is en- 
tered in the command line more than once, the most recent 
entry overrides any previous entry. 

When you enter the COM command without parameters, 
communication is started using the default values, which is 

tho eomo oc? on+orirxr 

> COM E =R L =0 T =00 M =4 C =T EOL =0D B =20 



Chi 



ch2 



b= 



bytecount 



The COM (COMmunication) command initiates communi- 
cation between the 8540 and a host computer. After you 
execute the COM command, you can enter host computer 
commands on the system terminal. 

Transferring Data. COM is used for transferring data 
between ules on the host computer and program/proto- 
type memory or I/O ports on the 8540. 

Refer to the Intersystem Communication of this manual for 
a complete description of COM command parameters, and 
for a detailed explanation of each type of transfer. Refer to 
the Operating Procedures of this manual for examples of 
each type of transfer. 

A transfer is accomplished by the following procedure: 

a. Enter the host computer command that transfers 
the data between the terminal and the appropriate 
file on the host system. (Do not enter a carriage 
return.) 

b. Enter the sequence of keystrokes (transfer 
sequence) that tells the 8540 what to send or 
where to store what it receives. The transfer 
sequence begins with a null character. 

Appropriate transfer sequences are listed in Table 3-2. 



Obtaining COM Status. Status information about the 
connection between the 8540 and the host computer is 
maintained in the 8-bit Remote Port Status Register. To 
display the contents of the Remote Port Status Register, 
enter the null character, then press the S key and enter a 
carriage return. The system terminal displays the register 
contents as two hexadecimal digits. Refer to the 
Intersystem Communication section for details about the 
Remote Port Status Register. 



Aborting a Data Transfer. To abort a data transfer, press 
the BREAK key. You may then attempt another data trans- 
fer, enter another host command, or exit from COM. 






I I V^>^IVI, CI II 



character and then press the ESC key. 
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COM 

Sets up communications with host computer 



Table 3-2 
Types of Data Transfer 



Name 


Type of 
Data 


Type of 
Transfer 


Source 


Destination 


Transfer 
Sequence^ 














Formatted 
Download 


Object Code 


Tekhex 
to Binary 


Host File 


8540 

Program Memory 


(nullKcr) 


Formatted 
Upload 


Object Code 


Binary 
to Tekhex 


8540 

Program Memory 


Host File 


(null) 
addresses^ (cr) 


Unformatted 

ASCII 

Download 


ASCII 


Copy 


Host File 


8540 Device 


(null) 
>device^ (cr) 


Unformatted 

Binary 

Download 


Binary 


Copy 


Host File 


8540 Device 


(null) 
=device^ (cr) 


Unformatted 

ASCII 

Upload 


ASCII 


Copy 


8540 Device 


Host File 


(null) 
<device^ (cr) 


Unformatted 

Binary 

Upload 


Binary 


Copy 


8540 Device 


Host File 


(null) 
+device'' (cr) 



(null)— null character (ASCII 00, usually CTRL-@) 
(cr)— carriage return 

' addresses— the starting and ending addresses of one or more blocks of program memory to be uploaded. The last pair of addresses 
may optionally be followed by the transfer address of the object code. 

device— the 8540 I/O device that is to provide or receive the data. 



O 
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SYNTAX 



config local 

or 

.. , r mir i°n. ,,rirn 

comig term 16= |i I ||i= ii j Jinri=pariiyj y= jnij Li=nexsiringj 



Timeout parameter. This is a multiplier that 
affects TERM interface protocol timeouts. 
For example, if t=5, then all thetimeouts will 
be five times as long as their default 
durations. 

u„»--4._; xu« i*:_i:^_ r« x i *_ rr. ^i 

r I CAS 1 1 iiiL| iiiciiiuiLiiJiid.v^driiaiiLiciiuiii iiurr, lilt; 

default is 1. If the multiplier starts with a 
letter (A-F) it must be preceded by a 0. 



local 
term 
e= 



parity 



PARAMETERS 

Places the 8540 in LOCAL mode. 

Places the 8540 in terminal (TERM) mode. 

Echo parameter. Applicable in TERM mode. 

Remote echoing. Characters entered at the 
terminal are echoed by the host computer. 
Default value. 

Local echoing. Characters entered at the 
terminal are echoed by the 8540 

Linefeed parameter. Applicable in TERM 
mode. 

Specifies that the 8540 will not output a 
linefeed with a carriage return. Default 
value. 

Specifies that the 8540 will output a 
linefeed with a carriage return. 

Parity parameter. Selects the parity option 
required by the host computer when it 
receives or sends data. Applicable when i=r 
(RS-232-C). 

Includes character transmission length and 
number of stop bits. Refer to a table of the 
Intersystem Communication section for the 
possible values of this parameter and what 
those values represent. Defaults to 6. 

Interface parameter. Applicable in TERM 
mode. 

Specifies that the 8540-host interface is the 
REMI/REMO port. 

Specifies that the 8540-host interface isthe 
HSI port. This is the default. 



EXPLANATION 

The CONFIG (CONFIGuration) command puts the 8540 in 
one of two possible system configurations when the 8540 
is connected to a host computer. In one configuration, 
TERM mode, the system acts just as if the terminal were 
connected directly to the host computer. In the other 
configuration, LOCAL mode, the system acts as if the 
terminal were connected only to the 8540. 



itKM and LUUAL Modes 

In TERM mode, all characters entered at the system 
terminal are sent directly to the host computer. This mode 
is particularly powerful when the host computer is an 8560 
Multi-User Software Development Unit. Refer to the 
Intersystem Communication section of this manual for 
more information on the useofTERM mode when the 8540 
is connected to an 8560. Refer also to the 8560 System 
Users Manual for details about using an 8540 connected to 
an 8560. 

In LOCAL mode, all characters entered at the system 
terminal are sent directly to the 8540 to be processed as 
OS/40 commands. The CONFIG LOCAL command 
produces the same effect as when the 8540 isn't 
connected to a host at all. 

Unless your host is an 8560, you should use the COM 
command (rather than CONFIG) to transfer data between 
the host and the 8540. 



Startup Configurations 

When you power up the 8540, you are in LOCAL mode. You 
may also achieve the effects of booting in TERM mode, 
using the startup command string. This feature is 
controlled by switch position number 1 (switch number 
S1 100) on the 8540 System Controller board. 
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If the switch Is closed (0), the 8540 executes the startup Changing Configurations 

command string named $STARTUP, residing in EEPROM. -r, ^ .. , 

The following list shows how to change the 8540/host 

If the switch Is open (1), $STARTUP is not executed. computer system configuration: 

1. From TERM mode to LOCAL mode: Enter the "config 
If you want the 8540 to boot up In TERM mode, close the local" command (8560) or re-boot the 8540. 

switch and include a CONFIG TERM command, with 

appropriate parameters, as the first command In the ^ '''°'^ ^^^^^ "^^^^ ^° ^^^^ "^o^e: Enter a CONFIG 

$STARTUP string command, Including TERM and other appropriate 

parameters. 
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SYNTAX 



[Iw] 



d L-wJ loaddr [hiaddr] 



PARAMETERS 

-b Selects byte-oriented output. 

-w Selects word-oriented output. 

(default) The default byte/word output format 

depends on the currently selected emulator. 
Refer to the Byte/Word Parameter dis- 
cussion in the Emulator Specifics supple- 
ment for your emulator processor. 

loaddr An expression representing the address of 

the first byte in program/prototype memory 
to be displayed. 

hiaddr An expression representing the address of 

the last byte in program/prototype memory 
to be displayed. Defaults to (loaddr+OFH) or 
the top of memory, whichever is less. 



EXPLANATION 

The D (Dump) command sends the contents of program or 
prototype memory to standard output (usually directed to 
the system terminal). 

D displays the hexadecimal representation of the data 
alongside the ASCII representation, in the ASCII repre- 
sentation, periods represent data bytes with hexadecimal 
values less than 20 or greater than 7E. 

The emulation mode and memory map assignments 
determine whether program or prototype memory data is 
displayed. Refer tothe EM and MAP command discussions. 



EXAMPLES 

For 8-bit processors, or if -B is specified, the D command 
output is in the format shown in Display 3-1 1. 

For 16-bit processors, or if -W is specified (where each 
address represents one byte), the D output is in the format 
shown in Display 3-12. 

For 16-bit processors with external word addressing 
(where each address represents one word), the D output is 
in the format shown in Display 3-13. 



> D 3 16 

3456789ABCDEF012 
nnnQHT 33 31 on no nn nn on on 41 4? 43 00 00 00 00 00 ?.1 
000013 00 30 31 32 .012 



ABC. 



address of 
first byte 
in block 



hexadecimal representation 
of bytes in block 



ASCII representation 
of bytes in block 



Display 3-11. 



> D 4 18 






468ACE02 






000004 3100 0000 0000 0041 4243 0000 0000 0000 


1. , . . 


• ABC 


U0u0i4 5051 5255 0000 


0123 . 





Display 3-12. 



'■ D 4 OE 








4-C 5/D 6 E 7'F 8.0 9/1 A/2 B 3 








000004 3100 0000 0000 0041 4243 0000 0000 0000 


1. . . , 


.ABC. . . 


. . . [words 4--B] 


OOOOOC 3031 3233 0000 


0123. 




[words C--E] 



Display 3-13. 
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DEAL 



Deallocates memory from logical address map 



SYNTAX 



deal (loaddr [hiadd 



.} 



PARAMETERS 

-a Deallocate all program mennory blocks. 

loaddr An expression representing the beginning 

address of the logical address block to be 
deallocated. If no nnemory space designator 
is used, all memory spaces in the given 
range will be deallocated. 

hiaddr An expression representing the ending 

address of the logical address block to be 
deallocated. Defaults to the ending address 
of the 4K-byte block specified by the loaddr 
parameter. 

EXPLANATION 

NOTE 

This command deallocates memory assignments 
made using the Memory Allocation Controller (MAC) 
version of the A L command, which is described in the 
Emulation section of this manual. If memory 
allocation was done using the version of the AL 
command described in this section, refer to the AL 
command for methods of restoring initial memory 
allocation settings. Refer to your Emulator Specifics 
supplement for further information. 



The DEAL (DEALIocate) command deallocates logical 
memory assignments. If memory had been allocated, DEAL 
causes physical memory to be made available for allocation 
to any logical address. 

An attempt to access a non-allocated program memory 
address will cause an error to occur. 



EXAMPLES 



> DEAL -A 



Deallocates all program memory. Makes all of program 
memory unavailable to your program. 

> DEAL 1000 IFFF 

Deallocates addresses 1 000-1 FFF. 

> DEAL 1000 

Deallocates all program memory from address 1 000 to the 
end of the block. Effectively the same as the previous 
example. 

> DEAL PROMEMLO PROMEMHI 

Deallocates memory from the beginning of the block 
containing the address PROMEMLO to the end of the block 
containing the address PROMEMHI. 



O 



3-25 



Dl 



Translates object code to mnemonics 
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SYNTAX 

di [loaddr] [hiaddr] [lines] 



disassembied. Refer to the MAP and EM command 
discussions. 

NOTE 

You must have SELectedthe target processor before 
executing the Dl command. 



PARAMETERS 

loaddr An expression representing the program/ 

prototype memory address where disas- 
sembly begins. Defaults to 0000. 

hiaddr An expression representing the program/ 

prototype memory address where disas- 
sembly ends. Defaults to the end of memory. 



EXAMPLES 

Disassemble Between Addresses 

To disassemble addresses 100-102, enter: 

> DI 100 102 

LOG INST MNEM OPER 
000100 210005 LXI H,0500 



lines The number of lines to be disassembled. 

If this parameter and hiaddr are omitted, 
disassembly continues until the end of 
memory is reached or until you enter 
CTRL-C. 

When you enter the Dl command without parameters, 
disassembly starts at address 0000, and continues until 
the end of memory is reached or until you enter CTRL-C. 



EXPLANATION 

The Di (Disassemble) command translates the object code 
in the specified memory area back into its corresponding 
assembly language mnemonics and operands, and sends 
this information to standard output, usually the system 
termmal. 

if you enter only a single address parameter, disassembly 
proceeds from that address to the end of memory, or until 
you enter CTRL-C. If you have only 32K of program 
memory, addresses 8000 through the end of memory are 
considered to be all zeros. 

The disassembly is erroneous if the specified loaddr does 
not contain the first byte of an instruction. Thedisassembly 
terminates when either the hiaddr is reached or the lines 
parameter is satisfied. 

The memory map assignments and emulation mode 
determine whether program or user prototype memory is 



Disassemble a Number of Lines 

Enter the following command line; 



> DI 100 lOE 4 

LOG INST MNEM OPER 

000100 210005 LXI H,0500 

000103 0605 MVI B,05 

000105 AF XRA A 

000106 86 ADD M 



Dl disassembles only to address 106: Only the first four 
iines are disassembied. This example is the same as 
entering Dl 100,, 4. 



Disassemble to an Ending Address 

Enter the following command: 

> DI 100 lOE 30 



LOG 


INST 


MNEN? 


OPER 


000100 


210005 


LXI 


H,0500 


000103 


0605 


MVI 


B,05 


000105 


AF 


XRA 


A 


000106 


86 


ADD 


M 


000107 


23 


INX 


H 


000108 


05 


OCR 


B 


000109 


C20601 


JNZ 


0106 


OOOIOG 


D3F7 


OUT 


F7 


vyiiiy a 


liucS 


srs 


uisasser 



I *\ — u: u_ 



parameter is reached. This example is the same as entering 
Dl 100 10E. 
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DS 



Displays contents of emulator registers 




(default) 



PARAMETERS 

Long display. Displays all the emulator 
registers. 

If -L is not specified, the DS command 
displays only the most frequently used 
emulator registers. Default and long dis- 
plays are the same for some emulators. 



emulator; however, each display line includes the 
following information: 

• the address of the next instruction to be executed by the 
emulator. 

• the emulator register contents. 

Refer to the Emulator Specifics supplement for the DS 
display format for your emulator. 

NOTE 

You must have SELectedthe target processor before 
executing the DS command. 



EXPLANATION 

The DS (Display Status) command displays the current 
status of the emulator. The display line varies for each 



EXAMPLES 

Select the 8085A emulator and display the current status 
of the emulator registers with the command sequence 
shown in Display 3-14. 



> SEL 8085 




> DS. 






PC=0000 


SP= 


program counter shows address of next instruction to be 
executed: initialized to 0000 when emulator is selected 

0000 F=00 A=00 B=00 C=00 D=00 E=00 H=00 L=00 


SOD=0 


SID 


=0 17=0 16=0 15=0 IE=0 M7=l M6=l M5=l 



Display 3-14. 



& 
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EM 

Selects emulation mode 
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SYNTAX 



em [mode] 



PARAMETERS 

mode One of the following modes: 

System mode. Execution in this mode 
uses program memory and the emula- 
tor clock and uses SVCs for I/O. Mode 
is set when an emulator is initially 
selected. 

1 Partial emulation mode. Execution in 
this mode uses program memory 
and/or user prototype memory, 
according to the map assignments. 
(Refer to the MAP command). Execu- 
tion also uses the prototype's clock 

rsi-kH rTno\/ I tc-ck Qit l-t£ir nrr\fr\i-\tr\ci I /O r\r Hi 
uiivj iiiujf uo<^ v^itiit^i pi vy Lv/ L y pv-F 1/ *«-» *-»» yii 

available) SVCs. 

2 Full emulation mode. Execution in this 
mode uses the prototype's memory, 
clock, and I/O. Mode 2 SVCs are 
available for some emulators. 

When you enter the EM command without parameters, the 
current emulation mode is dispiayed. 



EXPLANATION 

The EM (EMuiate) command selects the emulation mode. 
In emulation mode 1 or 2, your prototype must be 
connected to the 8540 via the prototype control probe. 

NOTE 

You must have SELectedthe target processor before 
executing the EM command. 



) 



CAUTION 



Be careful when writing to program memory in 
emulation mode 1: Memory write operations 
performed in program memory are also performed in 
user prototype memory, for most emulators. 



EXAMPLES 
Choose Emulator and Emulation Mode 

Select the 8085A emulator and emulation mode 2 with the 
foJiovA.'in'^ command lines: 

> SEL 8085 

> EM 3 

Display Current Mode 

To display the current emulation mode, enter: 

> EM 

8085 is in emulation mode 2 
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EX 



Displays or alters memory contents 



SYNTAX 



ex 



r-bi 

L-wJ [-n 



] address 



PARAMETERS 

-b Selects a byte-oriented input and output 

format. 

-w Selects a word-oriented input and output 

format. 

(default) The default byte/word input/output format 

depends on the currently selected emulator. 
Refer to the Byte/Word Parameter discus- 
sion in the Emulator Specifics supplement 
for your emulator. 

-n Suppresses the read-back check for the 

command. 

address An expression representing the address of 

the data in program/prototype memory that 
you wish to display or alter. Must be an even 
value if the -W option is used. 



EXPLANATION 

The EX (Examine) command permits you to display and 
(optionally) alter the contents of the specified address, as 
well as the contents of the subsequent addresses, on the 
system terminal. 

The EX command displays the specified address, an equal 
sign, the contents of the address, and a space. The contents 
of each address appear as two hexadecimal digits for byte 
processors, or four digits for word processors. Table 3-3 
lists your options when this information is displayed. 

The read-back check compares prototype memory contents 
after the command is finished to see if the memory was 



Table 3-3 
EX Command Options 



Entry 


Function 


Space Bar 


Displays the next address and its 
contents. 


BACKSPACE 


Displays the previous address and 
contents. 


LINEFEED or 
RUBOUT 


Displays the current address and 
contents. 


RETURN or 
CTRL-C 


Terminates the command. Memory loca- 
tions altered before entering CTRL-C or 
pressing the RETURN key remain altered. 


A hexadecimal 
data string 
(2 or 4 digits) 


Replaces the current data. The next 
data byte or word then appears on 
a new line. 



properly altered. If there is a difference between memory 
contents and what was sent to memory, an error is 
returned. You may want to suppress the read-back check 
when you know it's going to fail anyway, for example after 
you've written to prototype I/O. No read-back check is 
performed on writes to program memory. 

The emulation mode and memory map assignments 
determine whether program or prototype memory is 
selected. Refer to the EM and MAP command discussions. 



Alternative Commands 

To display blocks of memory contents, use the D command. 
To modify a sequence of bytes without checking their 
current contents, use the P command. 



EXAMPLES 

The example shown in Display 3-15 illustrates the various 
EX command actions that you can take. 



> EX 500 




000500-09 spacebar 


Displays the next address and 




contents on next line. 


000501=21 backspace 


Displays the previous address and 




its contents on next line. 


000500=09 linefeed 


Displays the current address and 




its contents on next line. 


000500=09 01 


Replaces current data and displays 




next address and its contents on next line. 


000501=21 backspace 


Displays the previous address and 




its contents on next line. 


000500=01 return 


Terminates the EX command. 



Display 3-15. 
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Fills program/prototype memory with data 
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SYNTAX 



f L-wJ[-n 



] loaddr hiadd 



J hexstring| 
r I -a string j 



PARAMETERS 

-b Selects byte-oriented filling of memory. 

-w Selects word-oriented filling of memory. 

(default) The default byte/word format depends on 

the currently selected emulator. Refertothe 
Byte/Word Parameter discussion in the 
Emulator Specifics supplement for your 
emulator processor. 

-n Suppresses the read-back check for the 

command. 

loaddr An expression representing the lower 

bound of the address range filled with the 
hexstring or string. Loaddr must represent 
an even value if the -W mode is used. 

hiaddr An expression representing the upper 

bound of the address range filled with the 
hexstring or string. Hiaddr must be greater 
than or equal to loaddr, and must represent 
an odd value if the -W mode is used. 

hexstring An even number of hexadecimal digits that 
represent a value to be stored in the 
specified memory area. If the current 
emulator is a 16-bit processor or the -W 
parameter is selected, there must be a 
multiple of four hexadecimal digits: other- 
wise, there must be a multiple of two 
hexadecimal digits. 

-a Specifies that the next string in the 

command line is to be an ASCII string. 

string An ASCII string to be stored in the specified 

memory area. If the current emulator is a 
16-bit processor or the -W parameter is 
selected, there must be an even number of 
ASCII characters. 



EXPLANATION 

NOTE 

In this discussion, the term "byte string" refers to the 
sequence of bytes or words that is the "filler" for the 
duration of the F command. The byte string is created 
by concatenating all hexstrings and ASCII strings in 
the command invocation into a single string. 



The F (Fill) command fills the specified memory area with 
the specified byte string. The lower memory address 
receives the fir.st bvte or word of the b^te strln", the next 
address receives the next byte or word, and so on until the 
memory area is filled. 

If the end of the byte string is reached before the upper limit 
of the address range is reached, filling continues with the 
beginning of the byte string. This process continues until all 
addresses within the specified range have been filled. 

When the memory area to be filled is not an exact multiple 
of the byte string length, filling stops at the specified upper 
address and a message indicating a truncation error 
appears on the system terminal. All previous addresses, 
however, retain their contents (already filled with the byte 
string). 

The read-back check compares prototype memory contents 
after the command is finished to see if memory was 
properly altered. If there is a difference between memory 
contents and what was sent to memory, an error is 
returned. No read-back check is performed on writes to 
program memory, i ou may want to suppress the read-back 
check when you know it will fail anyway, for example after 
you've written to prototype I/O. 

For 8-bit processors, you must enter each hexstring as a 
series of hexadecimal pairs. For 16-bit processors, the 
hexstring must contain a multiple of four hexadecimal 
digits. For example, you would enter the value B as OB for 
an 8-bit processor, and OOOB for a 16-bit processor. 

The memory area filled with the specified byte string may 
lie in program memory, user prototype memory, or both, 
depending on the memory map assignments and the 
emulation mode. Refer to the MAP and EM command 
discussions. 



EXAMPLES 



Fill with Zeros 



zeros: 

> F F 

F: Error 53 - Symbol not found 

An error occurs because the hexadecimal number was 
interpreted as a symbol, F, which does not exist. Try again: 

> F OF 

F: Error 37 - Invalid hexadecimal string 

Another error. A hexstring must contain an even number of 
hexadecimal digits. 

> F OF 00 

This time, no errors. Now check the contents of addresses 
0-F with the DUMP command line, as shown in Display 
3-16. 
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Fills program/prototype memory with data 



Fill with a Hexstring 

To fill memory locations 00-03 with the hexstring ABCD 
and display the contents, enter the command sequence 
shown in Display 3-17. 



Fill with an ASCII String 

Fill memory locations 00 to 03 with the string "ABCD", and 
display the contents, with the command sequence shown 
in Display 3-18. 

Notice that the memory values of the ASCII string are not 
the same as those of the hexstring. 



Fill with a Long String 

Fill memory locations 00 to 03 with the hexstring 
1 234567890 and display the contents with the command 
sequence shown in Display 3-19. 

Notice that althoughthe hexstring istruncated, all previous 
addresses retain their filled contents. 



Fill with Both Hex and ASCII String 

Fill memory locations 00 to OA with the combination of 
hexstring ABCD and ASCII string 'AB CD $EF' and display 
the contents with the command sequence shown in 
Display 3-20. 



> D 







































1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


000000 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 





Display 3-16. 



> F 


_3_ 


ABCI 








- a 


hexstring 


may 


Start with 


a 


etter 








> D 





































1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E F 


000000 


AB 


CD 


AB 


CD 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 00 





Display 3-17. 



> F 3 -A ABCD 




> D 




0123456789ABCDEF 




000000 41 42 43 44 00 00 00 00 00 00 00 00 00 00 00 00 


ABCD 



Display 3-18. 



> F 3 1234567890 




F: Error 56 - Truncation error 




■> D 




0123456789ABCDEF 




000000 12 34 56 78 00 00 00 00 00 00 00 00 00 00 00 00 


. 4Vx 



Display 3-19. 



> F OA ABCD -A 'AB CD SEE ^ 

> D 

0123456789ABCDEF 
000000 AB CD 41 42 20 43 44 20 24 45 46 00 00 00 00 00 . . AB CD SEE. 



hexstring ABCD 



ASCII string 
AB CD $EF 



Display 3-20. 



O 
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SYNTAX 



[address! 



PARAMETERS 

-r Causes this G command to be reinvoked 

each time a breakpoint is encountered. A 
break message is displayed at each break. 
This continues indefinitely until you enter 
CTRL-C. 

-I Same as -R, except trace and break lines are 

suppressed. 

(default) If neither -R nor -L is specified, the G 

command stops execution after the first 
break. 

address An expression representing the address 

where program execution begins. Defaults 
to the current value of the program counter, 
which is: 

1. The address following the last instruc- 
tion executed, if any; or 

2 The transfer address, if it exists and the 
program has not already been started; 
or 

3, Address 0000, if there is no transfer 
address and the program has net 
already been started. 



Entering the G command without parameters starts the 
program at the default address, as described above. 
E.xecutJon stc^s at the first breaknoint 



EXPLANATION 

The G (Go) command starts program execution, usmg the 
currently selected emulator. 

To interrupt program execution when your program reads 
from or writes to specified addresses, set breakpoints with 
the BK command. To suspend program execution, enter 
CTRL-C. 

If -R or -L is used, the G command repeats itself when the 
breakpoint is encountered. However, each time execution 
begins again, the emulator registers are not reset to the 
values they held when the G command was originally 
entered. 

For example, with the Z8001/Z8002 emulator, you may 
begin execution at an address in the System Code memory 
space. During the execution of the program and before the 
breakpoint is reached, the memory space being used may 
switch from System Code to another one, such as Normal 
Code. The emulator's register contents will have changed 
to reflect the change in memory space being used, so when 
the G command repeats according to the -R or -L modifier, 
execution begins in the wrong memory space (Normal Code 
instead of System Code.) 

NOTE 

If you have used the BK C command to specify that 
execution is to continue after a breakpoint, then the 
-R or -L modifiers of the G command have no effect 
That is, BK -C has precedence over G -R and G -L. 



3-32 



Command Dictionary — 8540 System Users 



Begins program execution 



EXAMPLES 

Select the 8085A emulator and emulation mode with the 
following command: 

> SEL 8085 

Set a breakpoint at a read from address 504 and start 
program execution at address 100 with the command 
sequence shown in Display 3-21. 



A break occurs when the instruction at location 1 06 reads 
data from address 504. 

If you specify the -R modifier in the G command line, the G 
command will be executed repeatedly. See Display 3-22. 



> BK 1 504 RD 




> G 100 




LOG INST MNEM OPER 


SP F A B D E H L IM SOD 


000106 86 ADD M 


0000 BO EO 01 00 00 00 05 04 07 


000106 <BREAK BKPT1> 





Display 3-21. 



> G -R 


100 




LOG 


INST MNEM OPER 


SP F A B C D E H L IM SOD 


000106 


86 ADD M 


0000 BO EO 01 00 00 00 05 04 07 


000106 


<BREAK BKPT1> 




000106 


86 ADD M 


0000 BO EO 01 00 00 00 05 04 07 


000106 


<BREAK BKPT1> 




000106 


86 ADD M 


0000 BO EO 01 00 00 00 05 04 07 


000106 


<BREAK BKPT1> 


(Enter CTRL-C to stop the 
repetition of G command execution.) 



Display 3-22. 



(a) 
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LO 

Loads program into memory 

LOG 

Logs terminal input/output to device 
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SYNTAX 



lo [parameters] 

or 

lo -o offset [parameters] 



PARAMETERS 

parameters One or more values to pass to the program 
being loaded. The program executes the Get 
Execution Line Parameter SVC (function 
code 1 C) to obtain these parameters one at a 
time. Refer to the Service Calls section for a 
description of the Get Execution Line 
Parameter SVC. 

-o Specifies load with offset. 

offset The amount to offset each block of object 

code from its designated memory location. 
Also adds an offset to the transfer address, if 
one is present. 



EXPLANATION 

The LO (LOad) command loads a load module from 
standard input into program/prototype memory. The input 
should be of the type created by an A-Series or B-Series 
assembler or linker. 

Each block of object code in the file is loaded into 
program./prototype memory starting at the location 



specified in the object code (plus any specified offset). The 
transfer address (if any) is loaded to the emulator's program 
counter. If there is no transfer address in the input, the 
emulator's program counter will be set to zero. 

I he standard redirection symbol (<) is used to indicate the 
load file on the host, which can be an object file created by 
an assembler, or a load file created by the SAV command or 
by a linker. 

The memory map assignments and emulation mode 
determine whether program memory or prototype memory 
contents are affected. Refer to the EM and MAP command 
discussions. 

NOTE 

When you use the LO command, your 8540 must be 
in TERM mode in order to access files on the host. 



EXAMPLES 

$ lo <CALORIES PIZZA BEER 

Downloads the contents of the 8560 load file CALORIES 
into memory. The parameters PIZZA and BEER can be 
accessed through the Get Execution Line Parameter SVC in 
the program. 

$ lo -o <PROBLEMS 100 YES NO 
Downloads the contents of the 8560 load file PROBLEMS 
into memory. Each block is loaded at the address equal to 
the location specified in the ob'ect code plus 100. The 
parameters YES and NO can be accessed through the Get 
Execution Line Parameter SVC in the program. 



SYNTAX 



log filespec 



PARAMETERS 



To turn off display to the logging device, enter the LOG 
CONO command. 



PYAMPI PC 



filespec The 8540 device that is to receive a copy of 

terminal input/output. 

EXPLANATION 

The log command causes a copy of most terminal 
input/output to be sent to the specified device or file. The 
LOG command is not intended for use in TERM mode. 



> LOG LPT 



(sends all terminal input/output to 
both the terminal and the line printer) 

(OS/40 commands) 



> LOG CONO 

(turns off display to the line printer) 






REV JAN 1983 
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MAP 



Sets or displays memory map assignments 







SYNTAX 


map [-m] 






or 






map option 


{loaddr 


[hiaddr]! ... 



PARAMETERS 

-nn Displays the current memory map assign- 

ments in matrix form. 

(default) If -M is not specified, the MAP command 

displays the current memory map assign- 
ments in vertical tabular form. 

option One of the following options: 

P Assigns the specified memory area 

to program memory. This option 
does not affect the memory protect 
status of these blocks. 

U Assigns the specified memory area 

to user prototype memory. This 
option does not affect the memory 
protect status of these blocks. 

PRW Assigns the specified memory area 
to program memory and sets the 
memory protect status to read and 
write. 



PRO 



URW 



URO 



RO 



RW 



Assigns the specified memory area 
to program memory and sets the 
memory protect status to readonly. 

Assigns the specified memory area 
to prototype memory and sets the 
memory protect status to read and 
write. 

Same as URW in emulation modes 
1 and 2; same as PRO in emulation 
mode 0. OS/40 does not support 
write protection for prototype 
memory. 

Assigns the specified memory area 
to be read only (ROM simulation) 
when mapped to program memory. 
This option does not affect the 
program/prototype assignments of 
this area. 

Assigns the specified memory area 
to be read/write memory when 
mapped to program memory. This 
option does not affect the program/ 
prototype assignments of this area. 



loaddr An expression representing the lower 

bound of the address range (starting at the 
specified address rounded down to a 128- 
byte multiple) assigned to program or user 
prototype memory. 

hiaddr An expression representing the upper 

bound of the address range (starting at the 
specified address rounded up to a 128-byte 
multiple) assigned to program or user 
prototype memory. Hiaddr must be greater 
than or equal to loaddr. Defaults to the end 
of the 1 28-byte block that contains the lower 
address. 

When you enter the MAP command without parameters, 
the current memory map assignments are displayed in 
tabular form. 



EXPLANATION 

NOTE 

The syntax and use of the MAP command may be 
different for some emulators (e.g. the 16- bit 
emulators}. Refer to your Emulator Specifics 
supplement for details. 

The MAP command sets memory map assignments or 
displays the current memory map status. The memory map 
is an internal table maintained by 08/40 that indicates 
which portions of memory used by the emulator are in 
program memory and which are in user prototype memory. 
When you SELect an emulator, the map is initialized sothat 
all memory is mapped to program memory (PRW option). 

The addressable memory space for most emulators is made 
up of 51 2 blocks of 1 28 bytes each. Refer to the Emulator 
Specifics supplement for the block size for your emulator. 
Each block may be assigned to either program or user 
prototype memory. Each block also has a memory protect 
status that either allows read and write operations or 
restricts access to read only. This memory protection 
feature is implemented only for program memory. 

The program/prototype assignments and memory protect 
status are independent. Therefore, in emulation mode 
(program memory only), options U, URW, and URO are 
interpreted as P, PRW, and PRO, respectively. In emulation 
mode 2 (prototype memory only), options P, PRW, and PRO 
are interpreted as U, URW, and URW, respectively. Notice 
that URO is the same as URW in emulation modes 1 and 2. 
Refer to the EM command for descriptions of the three 
emulation modes. 

If a write access occurs in a block of program memory that 
you have specified as read-only, an execution break will 
occur and no write operations will be performed. 
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MAP 



Sets or displays memory map assignments 
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You may specify either a single address or an address 
range. When you enter a single address, one block is 
mapped When yon specify any portion of a hlock the wholfi 
block is affected. Refer to the examples. 

The MAP command allows you to display the current 
memory map status (program/prototype memory assign- 
ment and memory protect status) in either of two forms. 
When you include the -M parameter in the command, the 
display is in matrix form: Each element represents one 
block of user prototype or program memory. The MAP 
command entered without parameters displays a vertical 
table that includes addresses or address ranges. 

Before setting memory map assignments, type EM 1 to 
enter emulation mode 1. Otherwise, the system terminal 
displays the message, WARNING— NOT IN EMULATOR 
MODE 1 . (The settings still take effect, however.) 

NOTE 

You must have SELectedthe target processor before 
executing the MAP command. 



CAUTION 



In emulation mode 1, memory write operations 
performed in program memory are also performed in 
the corresponding bytes of user prototype memory 
for most emulators. 



EXAMPLES 

Display Mapped Memory 

When you SELect an emulator, the memory map is 
initialized so that ali memory is mapped PRW. Enter the 
following command to display the memory map assign- 
ments: 

> MAP 

OOOO-FFFF PRW 



Set Memory Map Assignments 

Select emulation mode 1 before setting memory map 
assignments with the foilowiny COmmdnu itne. 

> EM 1 

Now you may set the memory map assignments. Notice 
that when ^ou s^ecif^ an^ nortion of a block, the whole 
block is affected. 

> MAP TT 7r?t^ i7an «n ^Cl^\ 



0700 0080 

to to 
17FF 017F 

The preceding command line assigns memory within 
address ranges 0700-1 7FF and 0080-01 7F to user 
prototype memory. 

> MAP PRO 55 5000,, 5200 617F 

The preceding command line assigns memory within 
address ranges 0000-007F, 5000-507F, and 5200-61 7F 
to program memory, and sets the memory protect status to 
read only. 

> MAP URO OAOOO OBFFF 

The preceding command line assigns memory within 
address range AOOO-BFFF to user prototype memory, and 
sets the memory protect status to read-only. 

Since OS/40 does not support write protection for 
prototype memory, this address range is write-protected 
only in emulation mode 0, when all memory is 
automatically mapped to program memory. 



Display Map Assignments 

Display the resulting memory map assignments in a 
vertical table, as shown in Display 3-23. 

Display the same memory map assignments in matrix form, 
as shown in Display 3-24. 
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MAP 

Specifies memory available to emulator 



> MAP 

0000-007F PRO 
0080-017F URW 
0180-06FF PRW 
0700-17FF URW 
1800-4FFF PRW 
5000-507F PRO 
5080-51FF PRW 
5200-617F PRO 
6180-9FFF PRW 
AOOO-BFFF URO 
COOO-FFFF PRW 

Display 3-23. 

> MAP -M 

PRW(-), PRO(=), URW(*), URO{.) 

0123456789ABCDEF 

0000 —* *- ** ** ** ** ** ** ** ** ** 

1000 ''" ** ** ** ** ** ** ** 

2000 -- 

3000 -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 

4000 -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 

5000 =- -- == == == == == == == == == == == == == == 

6000 == =- -- -- -- -- -- -- -- -- -- -- 

7000 -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 

8000 -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 

9000 -- -- -- -- — -- -- 

AOOO 

BOOO 

COOO -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 

DOOO -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 

EOOO -- -- -- -- -- -- -- -- -- -- -- -- -- -- 

FOOO -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 

Display 3-24. 
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Specifies memory available to emulator 
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SYNTAX 



mem [loaddr [hiaddr]] 



PARAMETERS 

loaddr An expression representing the beginning 

of the block of memory the emulator is 
allowed to access. 

hiaddr An expression representing the end of a 

block of memory the emulator is allowed to 
access. 

When you enter the MEM command with no parameters, 
the current MEM status is displayed. If your emulator has 
separate memory spaces, there will be a separate display 
for each address space. 

EXPLANATION 

NOTE 

Most emulators do not support the MEM command. 
Most emulators that do support the MEM command 
require the MAC option. Refer to your Emulator 
Specifics supplement for this information. 



The MEM (MEMory) command is used to reverse the 
effects of a previous NOMEM command. The NOMEM 

'^Ommarsd dSS''^n^t'^^ r*rr»t/^t\/r*Q nn£:imr\r\t oc rjonovictarit 

The MEM command designates prototype memory as 
existent. The default condition is for the entire range of 
prototype memory to exist. 

If your program tries to access memory that you have 
declared nonexistent, the system issues a break. 



EXAMPLES 

Designate Existent Memory 

> MEM 2000 2FFF 

This command designates user prototype memory 
addresses 2000-2FFF to be available to the emulator. 

> MEM SC:3000 

This command designates Z8001/Z8002 System Code 
addresses 2000 to the end of the block to be available to the 
emulator. 

> MEM NS:3400 

This command designates Z8001/Z8002 Normal Stack 
addresses 2400 to the end of the block to be available to the 
emulator. 
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MEMSP 



Defines memory space to be used by memory commands 



SYNTAX 



rs nnemspace 
memsp Lm memspace 



PARAMETERS 

s Specifies the default memory space for 

single-memory-space commands (see 
list below). 

m Specifies the default memory spaces for 

multiple-memory-space commands (see 
list below). 

memoryspace A two-character symbol that represents a 
specific memory space. Your Emulator 
Specifics supplement lists the correct 
memory space symbols for your emulator, 
if applicable. Default address space 
symbols are emulator-dependent. 



Entering the MEMSP command without parameters 
displays the currently set default memory spaces. 



EXPLANATION 

NOTE 

For most emulators, the MEMSP command is not 
applicable. In addition, you may need the MAC option 
if you wish to use memory space designators when 
referring to program memory. Refer to your Emulator 
Specifics supplement. 

The MEMSP (MEMory SPace) command specifies which 
memory space will be used when no memory space is 
specified in a command line. After the default spaces have 
been defined, you can enter commands without having to 
specify an address space with each address expression. 
The MEMSP command is only applicable for those 
emulators with memory spaces. 



Commands that accept a single memory space in the 
address expression use the default set by the MEMSP S 
command. The following commands are influenced by the 
MEMSP S command: 



COM 


Dl 


MOV 


RH 


SEA 


WPR 


CPR 


EX 


P 


RPR 


SVC 


WRT 


D 


F 


RD 


SAV 


WH 





Commands that accept multiple memory spaces in the 
address expression(s) use the default set by the MEMSP M 
command. The following commands are influenced by the 
MEMSP M command: 



AL 


MEM 


BK 


NOMEN 


MAP 





The MEMSP default setting may be overridden if a 
command would otherwise perform a meaningless 
operation on the memory space; for example, trying to 
disassemble a stack (Dl command). 



EXAMPLES 



> MEMSP S UP 

> D 400 4FF 



The MEMSP command selects User Data as the default 
68000 memory space for single-memory-space com- 
mands. The D command dumps the contents of User Data 
addresses 400-4FF. 

> MEMSP M ND NS NC 

> BK 1 3000 

The MEMSP command selects Normal Data, Normal Stack, 
and Normal Code memory spaces for multiple-memory- 
space commands for the Z8001 /Z8002 emulator. The BK 
command sets a breakpoint for any access to location 2000 
in the Normal Data, Normal Stack, or Normal Code memory 
spaces. 

> MEMSP 

Default single memory space ND 

Default multiple memory spaces. . .ND NS NC 

Displays current memory space defaults. 



O 
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Moves data between program and prototype memory 
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I uu I 



up 



pu 



pp 



loaddr 



hiaddr 



destaddr 



SYNTAX 



loaddr hiaddr destaddr 



PARAMETERS 

Both data source and data destination are 
user prototype memory. 

Data source is user prototype memory. Data 
destination is program memory. 

Data source is program memory. Data 
destination is user prototype memory. 

Both data source and data destination are 
program memory. 

An expression representing the lower 
address of the data block copied. 

An expression representing the upper 
address of the data block copied. Hiaddr 
must be greater than or equal to loaddr. 

An expression representing the lower 
address of the memory area to which the 
data block is copied. 



EXPLANATION 

The MOV command copies the specified data block from 

oiLlioi yiw^jiuiiivyi luooi pi vyLv/Ly po iiioiiiv/i y t.yj ci iiovv iwoulioii 

in either memory. 

If an error occurs when you try to move data to RAM which 

ovictc in iicor nrntrit\/r\o mornnrv/ \/mir r>rntnt\/nci nr\r\irr\\ 

probe may be malfunctioning. 

The MOV command is not affected by the current 
emulation mode, memory map assignments, and write 
protection settings. 

EXAMPLES 

Display the contents of program memory addresses 
100-10E as shown in Display 3-25. 

Copy the contents of program memory locations 100-10E 
to program memory addresses 300-30E. Then display the 
contents of memory addresses 300 through 30E. Refer to 
Display 3-26. 

The contents of memory addresses 100-10E remain 
unchanged. 

It is possible to copy the specified data block to memory 
locations within that same block. Refer to Display 3-27. 

The contents of program memory 2FF-303 are overwritten 
by the old contents of program memory 300-304. 



> D 100 lOE 




0123456789ABCDEF 




000100 21 00 05 06 05 AF 86 23 05 C2 06 01 D3 F7 00 ! . 


# 



MOV PP 100 lOE 300 




> D 300 30E 




0123456789ABCDEF 




r\r\i^'7r\r\ m r\r\ r\{z r^a r^c hrr' oc r>'7 rvc no nc m ■m irr? nn t 

KJ\jyUU\^\J C.± \J\^ \J<U W\J \J^^ rt.1 UW tj"J \^y^ OiL- WO \J J. LJKJ I I \J\J . . 


u 



Display 3-25. 

E F 
Display 3-26. 

E F 

00 21 

00 

Display 3-27. 



■ MOV PP 300 304 2FF 




• D 2F0 30E 


0123456789ABCDEF 




0002F0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 21 . . . 


: 


000300 00 05 06 05 05 AF 86 23 05 C2 06 01 D3 F7 00 


. . . .# 
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NOMEM 

Specifies memory unavailable to emulator 



SYNTAX 
nomem [loaddr [hiaddr]] 



PARAMETERS 

loaddr An expression representing the beginning 

of a block of memory the emulator is not 
allowed to access. May include memory 
space designators. 

hiaddr An expression representing the end of a 

block of memory the emulator is not allowed 
to access. 

Entering the NOMEM command with no parameters 
displays the list of memory blocks which are currently not 
available. There is a separate display for each memory 
space. 

EXPLANATION 

NOTE 

Most emulators do not support the NOMEM 
command. Most emulators that do support the 
NOMEM command require the MAC option. Refer to 
your Emulator Specifics supplement for this infor- 
mation. 



The NOMEM (NO MEMory) command designates 4K-byte 
blocks of prototype memory as nonexistent. The default 
condition is for all prototype memory to exist. 

If the emulator tries to access nonexistent memory, the 
system generates a break. 

The MEM command is used to reverse the effects of the 
NOMEM command. 



EXAMPLES 



> NOMEM 2000 2FFF 



Designates user prototype memory addresses 2000-2FFF 
as nonexistent. 

> NOMEM SC:£000 

Designates Z8001/Z8002 system code memory address 
2000 to the end of the block as nonexistent. 

> NOMEM NS:0 

Designates Z8001 /Z8002 normal stack memory address 
to the end of that block as nonexistent. 



O 
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SYNTAX 

b] Ihexstring 

P L~wJ[-n] address [-a string 



PARAMETERS 

-b Selects byte-oriented processing. 

-w Selects word-oriented processing. 

(default) The default byte/word format depends on 

the currently selected emulator. Refertothe 
Byte/Word Parameter discussion in the 
Emulator Specifics supplement for your 
emulator. 

-n Suppresses the read-back check for the 

command. 

address An expression representing the address 

\A/horo nnrlo altoriatinn Koninc If \mnrri mnHo 

is chosen (-W), the address must represent 
an even value. 

hexstring An even number of hexadecimal digits: the 
sequence of bytes to be patched into 
memory. If W is selected, or the current 
emulator is a 16-bit processor, the hex- 
string must be a multiple of 4 hexadecimal 
digits; otherwise, it must be a multiple of 2 
hexadecimal digits. 

-a Specifies that the next string in the 

command line is to be an ASCII string. 

string A string of ASCII characters that is patched 

into memory. If — W is selected, or the cur- 
rent emulator is a 16-bit processor, there 
must be an even number of ASCII 
characters. 



EXPLANATION 

The P (Patch) command replaces the memory contents 
beginning at the specified address with the byte sequence 
represented by the ASCII string(s) and/or hexstring(s). 

For byte-oriented processing, a hexstring must contain an 
even number of bytes. For word-oriented processing, the 
number of bytes in a hexstring must be a multiple of 4, and 
an ASCII string must have an even number of characters. 

You may enter a combination of hexstrings and ASCII 
strings in one P command entry. 

The read-back check compares prototype memory contents 
after the command is finished to see if memory was 
properly altered. If there is a difference between memory 
contents and what was sent to memory, an error is 
returned. You may want to suppress the read-back check 
when you know it will fail anyway, for example after you've 
written to prototype I/O. No read-back check is performed 
on writes to program memory. 

The previously set memory map assignments and 
emulation mode determine whether program memory or 
prototype memory contents are affected. Refer to the MAP 
and EM command discussions. 



EXAMPLES 
Patch with Hexstring and ASCII string 

Enter the following command line to replace the data 
starting at address with the hexstring OA and ASCii string 
AB: 

> P -B OA -A AB 



tt 



ASCII string 
.hexstring 
-Starting address 



Display the contents of addresses 0-OF, as shown in 
Display 3-28. 



> D 

uiiii54ti6y6yAbCDEi-' 




000000 OA 41 42 00 00 00 00 00 00 00 00 00 00 00 00 00 


.AB 


1 


ASCII string AB 


hexstring OA 





Display 3-28. 
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PERMSTR 



Stores user-defined string in EEPROM 







SYNTAX 


permstr 


-1 




or 






permstr 


-d [stringname ...] 


or 






permstr stringname 





PARAMETERS 

-I Lists the currently defined permanent user 

strings. 

-d Deletes the specified permanent string(s). If 

no stringname is given, all currently defined 
permanent strings will be deleted. 

stringname The user-assigned name for the string. 



EXPLANATION 

The PERMSTR command allows you to store strings (which 
have been previously defined) in EEPROM, to display the 
strings stored in EEPROM, and to delete one or more of 
these strings. For information on how to declare and use 
strings, refer to the discussion on "Strings" near the 
beginning of this Command Dictionary. 

An error occurs if any attempt to create more permanent 
strings when sufficient space is not available on EEPROM. 
Use the PERMSTR -D command to delete unwanted 
strings. A permanent string must be deleted before its 
value can be redefined. 



Permanent strings may compete for space in EEPROM with 
operating system patches created using the ROMPATCH 
command. Both EEPROM chips must be installed in order 
to use the PERMSTR command. 

EXAMPLES 

First, declare two temporary strings: 

> regset=""S R1=0 R2=2 R5=5^^ 

> raLnKel=^a000,2000^^ 

You can then list these temporary strings with the STR 
command: 

> STR -L 

regset S R1=0 RS=2 R3=5 
range 1 1000,2000 

Now store the strings in EEPROM with PERMSTR, and list 
them: 

> PERMSTR regset raxtgel 

> PERMSTR -L 

regset S R1=0 R2=2 R3=5 

range 1 1000,2000 

Delete one of the permanent strings, and list them again: 



> PERMSTR -D regset 

> PERMSTR -L 



range 1 



1000,2000 



Your temporary string definitions still exist, though, until 
you delete them with the STR -D command, or turn off the 
power to the 8540: 

> STR -L 

regset S R1=0 R2=2 R3=5 

rangel 1000,2000 
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Turns query mode on and off 
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SYNTAX 



query 



on 
off 



EXAMPLES 

After starting up the system, check the query mode setting 
by entering the command without parameters: 

> QUERY 
ON 



off 



PARAMETERS 

Turns query mode on. 

Turns query mode off. 



When you enterthe QUERY command without parameters, 
the current system-wide query status is displayed. 



EXPLANATION 

The QUERY command turns query mode on or off. When 
query mode is on, commands that have a -Q option will 
query. When the mode is off, those commands will query 
only if the -Q option is invoked. Query mode is initially on 
when you reboot or start up the system. 



command: 

> REMS SYMBOLl 

Remove ( scalar ) : SYMBOLl 



?Y 



The REMS command asks for confirmation before 
removing the symbol. You type "Y" for yes. To turn query 
mode off, enter: 

> QUERY OFF 

Now use the REMS command again to remove SYMBQL2. 
It will remove the symbol without asking for confirmation. 

> REMS SYMB0L2 

To turn query mode back on, enter: 

> QUERY ON 
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RD 



Reads from emulator port 



SYNTAX 



rd L-mJL-wJ portnu 



portnum 



If -M is used: an expression designating a 
memory location. The expression may 
include only one memory space designator. 



-s 



portnum 



PARAMETERS 

Specifies special read as opposed to normal 
read. Not valid with -M modifier. Refer to 
your Emulator Specifics supplement to see 
whether your emulator can use this 
modifier. 

Specifies that the value of portnum is a 
memory address (meaningful for memory- 
mapped I/O). This is the default for 
emulators that only have memory-mapped 
I/O. Refer to your Emulator Specifics 
supplement to see whether you can use the 
-M modifier. 

If this modifier is omitted, the portnum 
parameter is assumed to be a fixed port. The 
emulators that support both memory- 
mapped I/O and fixed-port I/O default to a 
fixed-port read. 

Specifies byte-oriented reading. Default 
value. 

Specifies word-oriented reading. 

If -M is not used: an expression designating 
a fixed I/O port. Refer to your Emulator 
Specifics supplement for the correct port- 
num values for your emulator. 



EXPLANATION 

The RD (ReaD) command reads a byte or a word from an I/O 
port on the emulator. This command is not available for 
most emulators. Refer to your Emulator Specifics 
supplement for details. 

If more than one portnum value is entered, reads will be 
performed and results displayed in the order the portnum 
parameters were entered. 



EXAMPLES 

To read from Z8001 /Z8002 emulator ports 70,73, and 7A, 
and display the values, enter the following command: 

> RD 70 75 7A 
0070=23 
0073=00 
007A=1F 

To perform a special byte-oriented read from Z8001/ 
Z8002 port symbolized by the symbol TERMACIA, and 
display the value, enter the following command: 

> RD -S TERMACIA 
00F0=23 

To read from the Z8001/Z8002 memory address 
symbolized by TERMACIA in normal data memory space, 
enter the following command: 

> RD -MW ND: TERMACIA 
ND:0000F0=0023 
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Removes symbol from symbol table 
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SYNTAX 



rems 



m 



sectionname: 
symbolspec 



If only the second part of the symbol is included in the 
symbolspec parameter (no section name), the REMS 
command searches for the s^'mbo! first in the current 
section, then in the entire symbol table, and removes only 
the first occurrence of that symbol. Refer to the Emulation 
section of this manual for more information on symbolic 



PARAMETERS 

-q Turns query mode on for the duration of 

this command. 

-n Turns query mode off for the duration of 

this command. 

(default) The default query mode depends on the 

current system-wide query status. Refer 
to the QUERY command. 

sectionname:* Represents all the symbols within the 
specified section. 

symbolspec The symbol to be removed from the 

symbol table. The symbolspec may 
include the sectionname if the symbol 
represents an address. 



EXPLANATION 

The REMS (REMove Symbol) command removes the 
specified symboKs) from the symbol table. 



When query mode is on, the REMS command queries you 
before removing the symbol. 



EXAMPLES 



> REMS ENDLIST 



This command line removes symbol ENDLIST from the 
symbol table. No section name is specified. 

The following command removes symbols APPLAUSE and 
KISSBABY, associated with sections SPEECH and ELEC- 
TION, respectively, from the symbol table. Both symbol- 
specs include both a section (the name before the colon) 
and a symbol which represents the address value (the 
name after the colon). 

> REMS SPEECH: APPLAUSE ELECTION: KISSBABY 

The following command removes all the symbols from the 
section WRITERS, 

> REMS WRITERS:* 
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RESET 

Reinitializes emulator 



SYNTAX 



reset 



NOTE 

You must have SELectedthe target processor before 
executing the RESET command. 



EXPLANATION 

The RESET command simulates a hardware reset by 
reinitializing the values of the emulator registers. 

The RESET command is emulator-dependent. Refer to the 
Emulator Specifics section for details on how the RESET 
command affects specific registers in your processor. 



EXAMPLES 

Check the register contents of an 8085A, enter the RESET 
command, and check the registers again, as shown in 
Display 3-29. 



DS 



PC=0111 SP=5500 F=65 A-04 B=49 C=88 D=66 E=87 H=01 L=22 
S0D = 1 510=^0 17=1 16=1 15=1 IE=1 M7=0 M6=0 M5=0 



RESET 



DS 



PC=0000 SP=5500 F=65 A=04 B=49 C=88 D=66 E=87 H=01 L=22 
SOD=0 SID=0 17=0 16=0 15=0 IE=0 M7=l M6=l M5=l 
k k k k k k k k 



(The arrows show the changed registers.) 



Display 3-29. 
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SYNTAX 




1 






rh 


t 


lollscll 





The RH command wiii not read or ioad any program 
symbols. Refer to the ADDS, SYMLO and COM commands 
for mformation on loading symbols into the symbol table. 

Each block of code is loaded into memory starting at the 
message block load address. Any offset amount is added to 
the load address for each data block transferred. 



(default) 



PARAMETERS 

Input IS Intel-formatted hexadecimal object 
code. 

Input IS Motorola-formatted hexadecimal 
object code. 

Input IS Standard Tekhex format. 

if no modifier is specified, input is Extended 
Tekhex format 



The emulation mode and the memory map assignments 
determine whether program memory or prototype memory 
contents are affected. Refer to the EM and MAP command 
discussions. 

To write rather than read hexadecimal object code, use the 
WH command. 

NOTE 

When you use the RH commaiui, your 8540 must be 
in TERM mode in order to access files on the host. 



offset 



An expression representing the amount to 
offset the load address of each data block. 






When you enter the RH command without parameters, 
Extended-Tekhex-formatted object code is read from the 
standard input into program/prototype memory without an 
offset. 

EXPLANATION 

The RH (Read Hexadecimal code) command reads 
'"lexadecima! objec' code from standard input, converts the 
code to binary, and loads the binary code into program or 
prototype memory. 

Each message block read by the RH command must be in 
ilie specified 'osd forma* Rpfpr tn thr: Tnbles sectiors for a 
discussion of the Tekhex, Intel, and Motorola formats. 



EXAMPLES 



rh PROG.THEX 



Reads Extended Tekhex formatted object code from the 
8560 file PROG.THEX, converts it to binary, and writes the 
object code into memory 

■ i-ti -1 PHOG.IHEX iOO 

Reads the Intel-formatted hexadecimal object code from 
the 8560 file PROG IHEX and converts it to binary. Adds an 
offset amount of 100 to each load address. For example, 
when the ioad address speciiieu by the message block is 
1 00, the data block is loaded at location 200. Specifying the 
offset parameter does not affect the transfer address, if one 
IS given. 
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ROM PATCH 

UpdaUfs operating system 









SYNTAX 






rompatch 


checksum 


pat 


chid patchaddress 


filespec 


hexstring 


or 












rompatch 


-d checksum 


patchid 






or 












rompatch 


-1 











filespec The name of the ROM file (or comnriand) to 

be patctied. The filespec must contain the 
ROM file level as well as the filename. (For 
example, in "/DEFLT/EX", "/DEFLT" is the 
ROM file level and "/EX" is the filename.) If 
the ROM file is not found, an error occurs 
and the command aborts. 

hexstring The data to be patched into memory: an even 

number of hex digits. 



CAUTION 



The ROMP A TCH command is intended to be used to 
update your operating system. Do not use this com- 
mand unless directed to do so by Tektronix. Errone- 
ous entries may invalidate your system. Certain 
options of the ROMPATCH command are not de- 
scribed in this manual. 

PARAMETERS 

d Deletes the last defined patch. 

-I Lists all the patches in EEPROM. 

checksum Helps insure that the patch has been 
entered correctly. The ROMPATCH com- 
mand calculates a checksum value for the 
characters of all parameters in the ROM- 
PATCH command line except the checksum 
parameter. The resulting value is then 
compared with the checksum parameter. If 
they are not the same, an error occurs and 
the command aborts. 

palchid The sequence number of the patch being 

entered or deleted. This parameter is 
compared to the last patchid number saved 
in EEPROM. If it is not one greater than the 
stored value, then an error occurs and the 
command aborts. 

patchaddress The address where the patch will be made 
relative to the load address of the file named. 



EXPLANATION 

The 8540 contains two EEPROM chips on wfiich updates to 
the operating system can be stored using the ROMPATCH 
command. These updates are then inserted in the 
command modules when they are loaded. Normally, the 
user will not invoke this command except when directed to 
do so by Tektronix. Usually this will be done via explicit 
written instructions. 

The ROMPATCH command performs several checks on 
your input to guard against acciciental or intentional 
erroneous entries. 

ROM patches may compete for space in EEPROM with 
permanent strings created using the PERMSTR command. 
It may be necessary to delete some strings in order to enter 
a new ROM patch. 



EXAMPLES 

Adding a Patch 

The following command line causes the hexstring 3FC24A 
to be entered as the 26th patch in the EEPROM. It patches 
the module /DEFLT/EX at address 1 1 24 relative to the load 
address of the module. 

• ROMPATCH 31 26 1124 /DEFLT/EX 3FC24A 

Deleting a Patch 

This command line deletes the 1 57th patch (which must be 
the last entered) from EEPROM. 

■ ROMPATCH -D 7>C 158 
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ROMPATCH 

Updates operating system 
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Listing Patches 

You can use the -L modifier to list all the patches currently 
in EEPROM. In the examnip shown in Disniav 3-30, 

• PATCH ID corresponds to "patchid" in the syntax block, 

• ROM FILE NAME corresponds to "filespec", 



PART NUMBER is the Tektronix part number excludmg 
the 020 prefix. 



PATCH corresponds to "hexstring". 



> ROMPATCH -L 








PATCH ID 


ROM FILE NAME PART NUMBER 


ADDRESS 


PATCH 


1 


/KERNL/Kl 


238501 


45A8 


878DAEDF9FB50F98C1BD 


2 


/DEFLT/ROMPATCH 


239700 


C240 


404040B3B405D2EF217A7B204376 
234BD7C7 


3 


/8085 /DS 


253200 


0024 


6C725A7183 


4 


/Z8001/BK 


318402 


28C4 


9C02DEF6A8BD2A4C2CC03065 



Display 3-30. 
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Assigns value to register or symbol 



SYNTAX 

s symbolspec=expression .. 



PARAMETERS 

symbolspec The name of the synnbol or register that 
receives a new value. May be a standard 
register name or a user-created symbol that 
is already in the symbol table. 

expression Any valid expression as defined in the 
"Legal Address Expressions" discussion in 
this section. 



EXPLANATION 

The S (Set) command assigns a new value to each register 
or symbol specified. RefertotheEmulator Specifics section 
of this manual for the specific registers associated with 
your emulator. 



EXAMPLES 

Assign Value to Register 

Select the 8085A emulator and display the contents of the 
emulator registers, as shown in Display 3-31. 

Reassign values to registers SP, F, and A with the following 
command: 

> S SP=OFFFF F=ll A=B+5 

Display the contents of the 8085A emulator registers 
again. See Display 3-32. 



Assign Value to Symbol 

Symbolic debug allows you to declare a symbol for a value 
using the ADDS command. This name can then be used in 
the S command: 

> ADDS SUM=1224H 



> S SUM=5 

Display the value of SUM with the following command: 

> CALC SUM 
5H 



> SEL 8085 

> DS 

PC=0000 SP=0000 F=00 A=00 B=00 C=00 D=00 E=00 H=00 L=00 
SOD=0 SID=0 17=0 16=0 15=0 IE=0 M7=l M6=l M5=l 



Display 3-31 



> DS 


i 


i 


1 














PC=0000 


t ! 

SP=FFFF F=ll A- 


t 

=05 B=00 C 


=00 D=00 E= 


=00 


H= 


=00 


L= 


=00 


SOD=0 


SID=0 


17=0 


16=0 15=0 


IE=0 M7=l 


M6 


=1 


M5 


=1 




(The 


arrows 


show the 


changed 


registers.) 













Display 3-32. 
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Saves memory contents in file 
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SYNTAX 



sav [_-lJ lloaddr hiaddr| ... [transfer] 



-s 



(default) 



loaddr 



hiaddr 



PARAMETERS 

Specifies A-series (small address space) 
format. 

Specifies B-series (large address space) 
format. 

Defaults to B-series format if the selected 
target processor can address more than 64K 
of memory; otherwise, defaults to A-series 
format. 

An expression representing the lower 
address of a block of program/prototype 
memory to be transferred to the file. 

An expression representing the upper 
address of a block of program/prototype 
memory to be transferred to the file. Hiaddr 
must be greater than or equal to loaddr. 



transfer An expression representing the address of 

the first instruction to be executed in the 
program. Defaults to the first loaddr. 



EXPLANATION 

The SAV command directs the specified contents of 
program/prototype memory to standard output In A Series 
or B Series load module format, suitable for loading with 
the LO or X commands. 

The memory map assignments and emulation mode 
determine whether program memory or prototype memory 
contents are affected. Refer to the MAP and EM command 
discussions. 

NOTE 

Your 8540 must be in TERM mode in order to create 
files on the host. 



EXAMPLE 

Display the contents of addresses 1 00-1 OE on the sysierxi 
terminal. See Display 3-33. 

Enter the following command to upload the contents of 
addresses 100-10E into the 8560 load file named LOAD. 

> sav -1 >LOAD 100 lOE 



> D 100 lOE 






1 2 3 4 5 6 7 8 9 A B 


c n F F 




000100 21 00 05 06 05 AF 86 23 05 C2 06 01 


D3 F7 00 : . 


M 







Display 3-33. 
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SEA 



Searches memory for value or string 







SYNTAX 




'-b ' 


j value [precision] ] 
[-r] loaddr [hiaddr] t -a string / 


sea 


-w 



PARAMETERS 

-b Selects a byte-oriented search. 

-w Selects a word-oriented search, and requires 

an even starting address, and an odd ending 
address. 

(default) The default byte/word format depends on 

the currently selected emulator. Refertothe 
Byte/Word Parameter discussion in the 
Emulator Specifics supplement for your 
emulator. 

-r Specifies to search for repeated occur- 

rences of the specified string. 

(default) If -R is not specified, the SEA command 

stops searching after one match is found. 

loaddr An expression representing the address in 

program/prototype memory where search- 
ing is to start. Must be even if the -W mode is 
used. 

hiaddr An expression representing the address in 

program/prototype memory where search- 
ing is to stop. Hiaddr must be greater than 
loaddr, and odd if the -W mode is used. 
Defaults to the highest address accessible 
by the target processor. 

value An expression that represents a value for 

which you want to search. Up to four bytes of 
precision are possible. 



precision The number of bytes required to match the 

specified search value. This number must 
be between 1 and 4. Defaults to 1 for byte 
mode, 2 for word mode. 

-a Specifies a search for an ASCII string. Must 

be followed by the target string. 

string The ASCII string for which you are 

searching. The maximum length of the 
string is limited only by the maximum length 
of the command line. 



EXPLANATION 

The SEA command searches the specified memory area for 
the given value or string. SEA will display the starting 
address of the first occurrence of the value or string; or of 
every occurrence if the repetitive search modifier (-R) is 
chosen. 

The memory map assignments and emulation mode 
determine whether program memory or prototype memory 
contents are affected. Refer to the MAP and EM command 
discussions. 



EXAMPLES 

Assume that addresses 0-OF contain the data shown in 
Display 3-34. 

Display 3-35 shows some examples of searching for the 
value 34 with different precision parameters: 

Search for the ASCI! string "45" with the following 
command: 



> SEA OF -A 45 
OOODH 



The starting address of the first occurrence of ASCII 45 
(hexadecimal 3435) is OOOD. 



> D 










0123456789ABCDEF 










000000 34 00 34 00 00 34 00 00 00 34 00 00 00 34 35 00 


4.4. 


.4. 


.4. 


.45. 



Display 3-34. 



> SEA OF 34 


(Default number of bytes of precision is 1) 


OOOOH 


(First occurrence of 34 is at OOOOH) 


> SEA OF 34 2 


(Search for the 2-byte value 0034) 


OOOIH 




> SEA OF 34 3 


(3 bytes of precision:000034) 


0003H 




> SEA OF 34 4 


(4 bytes of precision. 00000034) 


0006H 





Display 3-35. 



3-53 



SEL 

Selects target processor chip 
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SYMTAX 



set [chiDl 



chip 



rMi-jMivic I cna 

The name of the target processor. 



When you enter the SEL command without parameters, 
the currently selected processor name is displayed. 



You should use the SEL command to select a 
processor before you execute any of the fol 



target 
owing 



commands: 






ACQ 


CONS 


MAP 


AD 


COU 


PRO 


AL 


CTR 


QUA 


AS 


DATA 


RESET 


BK 


Dl 


SVC 


BRE 


DiSP 


TCLR 


BUS 


DS 


TRA 


CL 


EM 


TS 


CLOCK 


EVE 





EXPLANATION 

The SEL command specifies the command set for your 
processor. After you select a processor, all emulator 
commands will be appropriate for that specific processor. 
When the 8560 is host, SEL also causes the 8560 to select 
the appropriate assembler and high level language 
commands for the desired microprocessor. 



the SEL command with a chip parameter, the symbol table 
is cleared. 

The SEL command selects the target processor. The system 
then acts as if the following commands had been executed: 



AL 10 

BK ALL CLR 

CLOCK OFF 

EM 

MAP PRW 0000 FFFF 

RESET 

SVC ON 40 OFO 

SYMD -LS ON; SYMD OFF 

TCLR -X 

TRA OFF 



(for most emulators) 

(for most emulators) 
(for most emulators) 



At system start up, the command set is selected from the 
command group called DEFLT. 



EXAMPLES 

Display the currently selected processor with thefollowing 
command: 



Entering a SEL command with a chip parameter closes any 



> SEL 

no emulator 



Now, select the processor: 

> SEL 8085 



DiSpiSy tiic currently seiecteu processor aoain 

> SEL 
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STAT 

Displays system status 

STR 

Displays or deletes temporary user strings 



SYNTAX 



Stat 



EXPLANATION 

The STAT command displays the status of the emulator on 
standard output. The status information displayed in- 
cludes; 

• name of the selected processor 

• name of the last program loaded into program memory 

• I/O channel assignments 



EXAMPLES 

Display 3-36 is an example of STAT command output. 



> Stat 












8085 is 


the 


selected 


processor 






User pro 


gram 


was last 


loaded into p 


rogram 


memory 


Channel 


is 


assigned to DATAFILE 







Display 3-36. 





SYNTAX 


str-l 




or 




str -d stringname ... 





PARAMETERS 

-i Lists the currently defined temporary user 

strings. 

-d Deletes the specified string(s). If no string- 

name is specified, ail currently defined 
temporary strings will be deleted. 

stringname The user-assigned name for the string. 



EXPLANATION 

The STR command allows you to display all the currently 
defined temporary user strings or to delete one or more of 



these strings. For information on how to declare and use 
strings, see the discussion of "Strings" near the beginning 
of this Command Dictionary. 



EXAMPLES 

First, declare two strings: 

> regset="S R1=0 R2=2 R5=5'' 

> rangel ='''1000, 2000'^ 

List your currently defined strings with the following 
command: 

> STR -L 



regset S R1=0 R2=2 R3=5 
rangel 1000,2000 

Now delete the first string, and list the strings again with 
the following sequence of commands: 

> STR -D regset 

> STR -L 

rangel 1000,2000 



(W 



3-55 



SUSP 

Suspends commands 
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SYNTAX 



SUSP 



I command \ 



PARAMETERS 

command The name of a 08/40 command: any 
command listed in this Command Dic- 
tionary. 



EXPLANATION 

The SUSP command suspends execution of the specified 
command. To suspend a particular command, first press 
CTRL-C and then enter the SUSP command with the name 
of the command. The command remains suspended until 
you abort it with the A command, or continue it with the CO 
command. To suspend all active processes, enter SUSP -A. 

Refer to the A command explanation for a iisT of commands 
that may not be suspended. 



All active commands. 
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SVC 



Controls execution of service calls from user program 



SYNTAX 



SVC 



ron-i 
Loff J [addr 



ess] [port] 



PARAMETERS 

on Turns on user SVCs. 

off Turns off user SVCs. 

(default) If neither ON nor OFF is entered, the current 

SVC ON/OFF status remains unchanged. 

address An expression specifying where in memory 

the SRB vector will begin. The default value 
(usually 40H) is emulator-dependent; Refer 
to your Emulator Specifics supplement for 
details. 

If the address parameter is omitted, the 
location of the SRB vector remains un- 
changed. 

port An expression representing the lowest I/O 

port address to be used by your program to 
initiate service calls. The I/O port range 
defaults to F0-F7. The port parameter 
should be a multiple of 1 0H, thus specifying 
a range of the form n0-n7, where n is a 
hexadecimal number between OandF. If the 
port parameter is omitted, the I/O port 
range remains unchanged. 

When you enter the SVC command without parameters, 
the current SVC capability (ON or OFF), SRB vector address, 
and SVC I/O port range are displayed. 



EXPLANATION 

NOTE 

SVC command default values may be different for 
some emulators. Refer to your Emulator Specifics 
supplement for details. 



The SVC (Service Calls) command turns the SVC capability 
on and off in all three emulation modes. Refer to the 
Service Calls section of this manual for an explanation of 
SVCs. 

Entering emulation mode automatically turns SVCs on. 
Entering emulation modes 1 or 2 automatically turns SVCs 
off. 

If SVCs are ON, any I/O instruction in your program that 
can be interpreted as an SVC request will initiate the 
appropriate SVC. If SVCs are OFF, such I/O instructions 
will be treated as normal code by the emulator, and no SVC 
request will be generated. 

You may also use the SVC command to specify where the 
SRB vector will begin and which I/O ports can be used to 
initiate SVCs. 

Initial SVC settings may be restored at any time by 
executing the following command: 

> SVC ON 40 OFO 

NOTE 

You must have SELectedthe target processor before 
executing the SVC command. 

Certain SVC features, such as the parameters of the 
SVC command and the capacity for SVCs in modes 1 
and 2, are emulator-dependent. Refer to the 
Emulator Specifics section of this manual for this 
information. 



EXAMPLES 

Enter the following command to display the current SVC 
settings: 

> SVC 

User SVCs are ON . 

The SRB vector is 0040. 

The I/O address is FO. 

Change the location of the SRB vector to 200 and the SVC 
I/O port range to 0-7 with the following command: 

> SVC, ,300 

Display the SVC setting again: 

> SVC 

User SVCs are ON . 

The SRB vector is 0200. 

The I/O address is 00. 
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Returns symbolic name for address 
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The format of the returned expression is influenced by the 
-S and -L options previously specified with the SYMD 
command. SYMB temporarily turns SYMD ON when 
returning the expression. 



PARAMPTPRQ 



expression .An expression whose symbolic equivalent 
you want to display, if one exists. 



EXPLANATION 

Given an expression, SYMB returns an equivalent symbolic 
expression of the form "addresssymb" or "section + offset", 
where "offset" is the displacement of the address relative 
to the start of the section. Symbols representing scalar 
values will not appear in the returned symbolic expression. 

To do the opposite, that is, to find the value associated with 
a symbol, use the CALC command. 



EXAMPLES 

If there is an symbol which represents an address and 
matches the specified expression, and the SYMD -SL 
options are enabled, the SYMB command will display the 
symbol as shown in the following command line: 

> SYMB 1254H 
1234H-LABEL001 

If no address symbol corresponds to the specified 
expression, the system responds with the section name 
and byte offset of the given value; 

> SYMB 153AH 
132AH=SECTI0N3+00AH 
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SYMD 



Controls symbolic display output 





SYNTAX 


symd off 




or 




symd [-S] [-1] on 





substituted for the appropriate addresses in the command 
output. 

SYMD does not effect your ability to use symbols in 
expressions, or to use the ADDS command. 

SYMD is automatically turned Off whenever you SELect an 
emulator. 



off 
on 
-I 

-s 



-si 



PARAMETERS 

Turns off symbolic debug output. 

Turns on symbolic debug output. 

Enables address symbol (label) substitutions 
only. Turns off offset substitution. 

Enables the substitution (for each hexa- 
decimal address) of its offset relative to the 
start of its section (shown in the location 
counter field of your assembler listing). 
Turns off address symbol substitution. 

Enables the substitution of both symbols 
representing addresses and section names 
with offset. 



If SYMD ON is entered without modifiers, SYMD is enabled 
with the most recently selected features. 

EXPLANATION 

The SYMD command affects the output of commands such 
as SYMB, TRA and Dl. If SYMD is on, symbols are 



No "sectionname + offset" will appear for absolute 
sections. 

For more information about symbolic debug, refer to the 
Emulation section of this manual. 



EXAMPLES 

Display 3-37 illustrates output produced by the TRA 
command when SYMD is ON and options -S and -L are 
both enabled. (Exact displays are emulator-dependent.) 

The address symbols, such as LABELOOl , are symbols from 
the label field in your assembly language source code. The 
byte offset addresses (+000, +003, etc.) correspond to those 
in the location counter field of your assembler listing. Thus, 
symbols in your trace output can make it easier to find 
trouble spots in your source code. 

For comparison, Display 3-38 shows output produced by 
the TRA command when SYMD is OFF. (Again, exact 
displays are emulator-dependent.) 



LOG 


INST 


MNEM 


R 


OPER 


X/PC EADD 


RA 


RB 


XREG 


SP 


CC 


SECTION: ALPHA 




















+000 


CEOOIO 


LDX 




0010 




00 


00 


0010 


0001 


DO 


+003 


5F 


CLR 


B 






00 


00 


0010 


0001 


D4 


LABELOOl 


A600 


LDA 


A 


00 


+0010=0010 


00 


00 


0010 


0001 


D4 


+006 


ABOl 


ADD 


A 


01 


+0010=0011 


00 


00 


0010 


0001 


D4 


LABEL002 


C900 


ADC 


B 


00 




00 


00 


0010 


0001 


D4 


+00A 


AB02 


ADD 


A 


02 


+0010=0012 


00 


00 


0010 


0001 


D4 


+00C 


7E1055 


JMP 




1055 


1055 


00 


00 


0010 


0001 


D4 


SECTION: BETA 




















LABEL003 


C900 


ADC 


B 


00 




00 


00 


0010 


0001 


D4 


+007 


AB03 


ADD 


A 


03 


+0010=0013 


00 


00 


0010 


0001 


D4 



Display 3-37. 
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Controls symbolic display output 
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> TRA ALL 




























> TRA JMP 0106 0110 


























> G 100 




























LOG INST 


MNEM 


OPER 


SP 


F 


A 


B 


C 


D 


E 


H 


L 


IM 


SOD 


000100 210005 


LXI 


H,0500 


0000 


04 


OF 


01 


00 


00 


00 


05 


00 


07 





000103 0606 


MVI 


B 05 


0000 


04 


AE> 


nt 


r\r\ 


00 


00 


nc 


f\r\ 


07 





000105 AF 


XRA 


A 


0000 


44 


00 


05 


00 


00 


00 


05 


00 


07 





000109 C20601 


JNZ 


0106 


0000 


10 


01 


04 


00 


00 


00 


05 


01 


07 





000109 C20601 


JNZ 


0106 


0000 


14 


03 


03 


00 


00 


00 


05 


02 


07 





000109 C20601 


JNZ 


0106 


0000 


10 


06 


02 


00 


00 


00 


05 


03 


07 





000109 C20601 


JNZ 


0106 


0000 


10 


OA 


01 


00 


00 


00 


05 


04 


07 





000106 86 


ADD 


M 


0000 


04 


OF 


01 


00 


00 


00 


05 


04 


07 






Display 3-38. 
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SYMLO 



Loads symbols into symbol table 



SYNTAX 



symlo [-a] [-g] [-s] [sectionname] 



PARAMETERS 

-a Appends new symbols to the table. If -a Is 

omitted, symbols currently in the table will 
be overwritten. Do not use -a in the first 
SYMLO after a SELect or reboot since you 
must overwrite the dummy section "NO. 
SECTION" with which the system is 
initialized. 

-g Loads global symbols only. Works with B- 

Series linker output only. (Global symbols 
are explained in your Assembler Core Users 
Manual.) 

-s Loads symbols representing scalars as well 

as those representing addresses. 

sectionname Name of a section of object code from which 
the symbols will be loaded. If no section 
names are specified, symbols from all 
sections are loaded. 



EXPLANATION 

SYMLO (SYMbol LOad) loads symbols from standard input 
into the symbol table for use in symbolic debug. The input 
should be of the type produced by an A-Series or B-Series 
linker. Refer to the Emulation section of this manual for 
more information about symbolic debug. 

NOTE 

When you use the SYMLO command, your 8540 
must be in TERM mode in order to access files on the 
host. 



EXAMPLE 

To load all the symbols in the load file BOL23 into the 
symbol table, including global symbols and scalar symbols, 
enter: 

> symlo -S <B0L23 



(S) 
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TRA 



Controls display of executed instructions 
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SYNTAX 



tra 

or 



tra 



[h] 



/all 1 



p-n^ imp 
[-S] L-l J I off }[ 



ioaddrl fhiaddr] 



-s 



-I 



(default) 



all 



PARAMETERS 

Stops execution after each trace line is 
displayed. If -S is not specified, the program 
continues execution after each trace line is 
displayed. 

Selects long display. Shows all registers on 
subsequent trace output. 

Selects normal display. The contents of only 
the most important registers are reported. If 
the microprocessor has few registers, all 
registers are shown whether or not -L is 
specified. 

If -L and -N are omitted, the most recent 
selection remains in effect. 

Every instruction is displayed after its 
execution. 

wibpidys oniy jump insiruciionsi uncon- 
ditional jumps, subroutine calls, and condi- 
tional branches where the specified condi- 
tio is satisfied. 



off Disables trace display. 

loaddr An expression representing the lower 

bound of the address range to which ALL, 
JMP, or OFF applies. Defaults to 0. 

hiaddr .An exr^ression ref^resentinn the ui^f^er 

bound of the address range to which ALL, 
JMP, or OFF applies. Defaults to the top of 

iiioiiiwiy. iiiauai iiiUoL uc yicdLci iiiaii 

loaddr. If both loaddr and hiaddr are 

specified and loaddr does not contain the 
first byte of an instruction, tracing starts at 
the next instruction after loaddr. 

When you enter the TRA command without parameters, 
the current trace conditions are displayed. 



EXPLANATION 

The TRA command establishes the conditions for 
displaying trace lines during program execution. Each trace 






, X *t : 4... 



line i^ui iiaii lo II ic auui coo ui iiic iitoiiu^iiuii, iiic iiioi.iuoi.iuii 

itself in hexadecimal, the mnemonicforthe instruction, the 
operand, and certain processor register contents. The trace 
line display format varies for each microprocessor type. 
Refer to the Emulator Specifics section for the TRA 
command description that corresponds to your emulator. 

Up to three TRA selections may be active at a time. The 
most recently entered selection takes precedence over any 
previously entered commands, A TRA ALL or TRA JMP 
commancj entereo witnout auciress parameters replaces aii 
existing selections. If you enter a TRA OFF command 
without address parameters, all previously entered TRA 
selections are deleted. 
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TRA 



Controls display of executed instructions 



You may enter TRA-LorTRA-N at anytime, no matter how 
many other selections are currently active. The -L and -N 
forms apply to the entire memory space regardless of the 
ranges specified in any previous TRA command lines. 



NOTE 

You must have SELectedthe target processor before 
executing the TRA command. 

When any TRA selections are in effect, your program 
executes at less than normal speed, even in those 
parts of the program that are not traced. 



EXAMPLES 

Display 3-39 is an example of 8085A TRA command 
output. 

When you enter the TRA command without parameters, 
the current trace conditions are displayed on standard 
output, as in the following example: 

> TRA 



TRA 
TRA 



ALL, 000000, OOFFFF 
JMP, 000106, 000110 



In this example, TRA ALL conditions are set for addresses 
0000 to 01 05, TRA JMP conditions are in effect from 01 06 
to 01 10, and TRA ALL conditions are again in effect from 
0111 toFFFF. 



> TRA ALL 






























> TRA JMP 0106 0110 




























> G 100 






























LOG 


INST 


MNEM 


OPER 


SP 


F 


A 


B 


G 


D 


E 


H 


L 


IM 


SOD 




000100 


210005 


LXI 


H,0500 


0000 


04 


OF 


01 


00 


00 


00 


05 


00 


07 


°1 


TRA ALL 


000103 


0605 


MVI 


B,05 


0000 


04 


OF 


05 


00 


00 


00 


05 


00 


07 


A 


in effect 


000105 


AF 


XRA 


A 


0000 


44 


00 


05 


00 


00 


00 


05 


00 


07 


0^ 




000109 


G20601 


JNZ 


0106 


0000 


10 


01 


04 


00 


00 


00 


05 


01 


07 


0\ 




000109 


C20601 


JNZ 


0106 


0000 


14 


03 


03 


00 


00 


00 


05 


02 


07 





TRA JMP 


000109 


G20601 


JNZ 


0106 


0000 


10 


06 


02 


00 


00 


00 


05 


03 


07 


A 


in effect 


000109 


C20601 


JNZ 


0106 


0000 


10 


OA 


01 


00 


00 


00 


05 


04 


07 


o) 




000106 


86 


ADD 


M 


0000 


04 


OF 


01 


00 


00 


00 


05 


04 


07 





TRA ALL 
in effect 



Display 3-39. 
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wh 



m 

t 



SYNTAX 



jloaddr hiaddri ... [transfer] 



-m 



(default) 



loaddr 



PARAMETERS 

Output is Intel-formatted hexadecimal ob- 
ject code. 

Output is Motorola-formatted hexadecimal 
object code. 

Output is in Standard Tekhex format. 

If none of the output options (-i, -m, or -t) is 
specified, output is in Extended Tekhex 
format. 

An expression representing the lower 
address of a data block in program/proto- 
type memory to be converted and trans- 
ferred to the file or device. 



then transferred to standard output. You may specify a file 
or device using the redirectional arrow (>). 

For examples of WH command output in Tekhex, Intel, and 
Motorola formats, see the Tables section. 



The WH command does not write out the symbols from the 
symbol table. 

The contents of memory are not affected by the WH 
command. 

The memory map assignments and emulation mode 
determine whether program memory or prototype memory 
contents are written. Refer to the EM and MAP command 
discussions. 

To read hexadecimal object code from a file or device, 
rather than to write it, use the RH command. 

NOTE 

When you use the WH command, your 8540 must be 
in TERM mode in order to access files on the host. 



hiaddr 



transfer 



An expression representing the upper 
address of a data block in program/proto- 
type memory to be converted and trans- 
ferred to the file or device. 

An expression representing the starting 
address of the program. Defaults to 0. 



EXPLANATION 

The WH (Write Hexadecimal code) command converts the 
specified data blocks within program or prototype memory 
from binary to hexadecimal format. The converted data is 



EXAMPLES 

Check the contents of memory 40-1 OF with the D 
command. See Display 3-40. 

Convert the data in program memory locations 40-42 and 
100-10E to Standard Tekhex format, and upload the 
converted code to the 8560 file named DEMO.THEX with 
the following command: 

> wh -t >DEMO.THEX 40 42 100 lOE 100 

When the data is again read into program memory, the 
emulator program counter will be set to the transfer 
address (100). 



> D 40 lOF 

0123456789ABCDEF 

000040 00 42 lA 00 00 00 00 00 00 00 00 00 00 00 00 00 . B 

000050 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000070 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000090 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000100 21 00 05 06 06 AF 86 23 05 C2 06 01 D3 F7 00 00 1 #. 

Display 3-40. 
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WRT 

Writes to emulator I/O port 

X 

Loads and executes program 



SYNTAX 



r-s J-wl 
/rt L-mJL-b Jportnum value 



-s 



(default) 



PARAMETERS 

Specifies special write as opposed to normal 
write. Not valid with -M nnodifier. Refer to 
your Emulator Speciflcssuppiementtosee if 
your emulator can use this modifier. 

Specifies that the value of portnum is a 
memory address (valid for memory-mapped 
I/O.) -M is the default for emulators with 
only memory-mapped I/O. Refer to your 
Emulator Specifics supplement to see if you 
can use the -M modifier. 

If this modifier is omitted, the portnum 
parameter is assumed to be a fixed port. The 
emulators which support both memory- 
mapped I/O and fixed-port I/O default to a 
fixed-port write. 

Specifies byte-oriented writing. 

Specifies word-oriented writing. 

If neither -B nor -W is specified, the default 
is byte-oriented writing. 



portnum If -M is not used: an expression designating 

a fixed I/O port. Refer to your Emulator 
Specifics supplement for the correct port- 
num values for your emulator. 

If -M is used: an expression designating a 
memory location. The expression may 
include only one memory space designator. 

value A valid expression. Its value must not exceed 

the maximum possible valueof the indicated 
word or byte. 



EXPLANATION 

The WRT (WRiTe) command writes a byte or a word to an 
I/O port on the emulator. Thiscommand is not availablefor 
most emulators: Refer to your Emulator Specifics 
supplement for details. 



EXAMPLES 



> WRT 70 00 



Writes the value 00 to emulator port 70. 

> WRT -S TERMACIA 88 

Performs a special byte-oriented write to the Z8001/ 
Z8002 port represented by the symbol TERMACIA. 



SYNTAX 



X [parameters] 



NOTE 

When using the X command, your 8540 must be in 
TERM mode in order to access files on the host. 



PARAMETERS 

parameters One or more values to pass to the program. 
The program executes a Get Execution Line 
Parameter SVC (function code 1C) for each 
of these parameters. Refer to the Service 
Calls section for a description of the Get 
Execution Line Parameter SVC. 



EXPLANATION 

The X (eXecute) command performs the same function as 
entering the LO and G commands sequentially. 

The standard redirection symbol (<) is used to indicate the 
load file on the host, which can be an object file created by 
an assembler, or a load file created by the SAV command or 
by a linker. 



EXAMPLES 

Before initiating program execution, you must select the 
desired processor and the emulation mode. 

> sel 8085 

> em 1 

Now you can execute the program in the 8560 load file 
CHECKBOOK by entering: 

> X <CHECKBOOK DEPOSIT 200 



This command loads CHECKBOOK into program memory 
and begins program execution. The parameters DEPOSIT 
and 200 can be accessed through Get Execution Line 
Parameter SVCs in the program. 



(5) 
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INTERSYSTEM COMMUNICATION 



INTRODUCTION 

This section is designed to help you establish communication 
between the 8540 and an external computer system. 

In this section, the term "intersystem communication" 
refers to the general process of communication between 
an 8540 and an external computer. A method for 
intersystem communication is necessary whenever you 
have information on one computer system that must be 
speedily and accurately transferred to another computer 
system. 

This section includes basic definitions and examples, 
algorithms for use in writing required software, and 
troubleshooting techniques. This section is organized as 
follows: 

• Terminology. Defines the terms used in the section. 

• 8540/8560 TERM Interface. Briefly describes the 
special interface between an 8540 and an 8560 Multi- 
user Software Development Unit. 

• COM Interface. Summarizes the types of data transfers 
possible between an 8540 and a computer other than an 
8560. 

• 8540/8550 Interface. Describes how an 8550 
Microcomputer Development Lab operates as a host 
computer to an 8540. 

• 8540/8002A Interface. Describes how an 8002A 
/^Processor Lab operates as a host computer to an 8540. 

• 8540/General Host Interface. Describes how the 
8540 communicates with a computer that is not an 
8560, 8550, or 8002A. Includes communication 
protocols, Standard and Extended Tekhex load module 
formats, COM command parameters, and hardware and 
software requirements for the host computer. 



TERMINOLOGY 

The terms "host" and "host computer" refer to a computer 
system that directs or presides over one or more 8540s. 
Programs are created on the host, then downloaded to the 
8540 to be executed and debugged. 

"Upload" refers to the transfer of data from an 8540 to a 
host computer. "Download" refers to the transfer of data 
from a host computer to an 8540. 



A "TERM interface" is a special arrangement between an 
8540 and a host 8560 in which you have access to all the 
resources of the 8540 and the 8560 simultaneously. (You 
initiate a TERM interface by entering the OS/40 command 
CONFIG TERM.) 

A "COM interface" is a setup that is used principally forthe 
transfer of object code between an unspecified host 
computer and an 8540. (You initiate a COM interface by 
entering the COM command on the 8540.) 



8540/8560 TERM INTERFACE 

The 8560 System Users Manual contains a detailed 
discussion of the 8560's TERM interface with an 8540 or 
8550. This subsection is a brief summary of that 
discussion. 



Setup 



When operating in TERM mode, the 8540 and 8560 
communicate using a high-speed interface (HSI) over a line 
that runs from an HSI I/O connector on the 8560 to the HSI 
connector on the 8540. (The 8540 and 8560 can also 
communicate using RS-232-C protocol, as through a 
modem. In this case, the communications line connects to 
the DTE jack (J101) on the 8540.) Your system terminal 
may be connected to another HSI I/O connector on the 
8560, or to the 8540 (as in the stand-alone configuration 
for the 8540). For the purposes of this discussion, we will 
assume that the terminal is attached to the 8540, and that 
the 8540 and 8560 are connected via an HSI line. 

You establish communication by placing the 8540 inTERM 
mode with the OS/40 command CONFIG TERM. In TERM 
mode, the 8540 passes every character you type directly to 
the 8560, and passes 8560 responses directly to the 
terminal. Once you log in to TNIX (the 8560 operating 
system), you can intermix OS/40 commands and TNIX 
commands, execute OS/40 commands from TNIX shell 
files, and download and upload programs between the 
8540 and the 8560. In order for SVCs in your program to 
access files on the 8560, the 8540 must be in TERM mode. 



O 
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Command Execution 

Fx/orv/ r-nmmanrj lino v/r>M ontor jo r>r/->oQocQH fjfSt b" thS 

8560. if it is an OS/40 command, the 8560 passes the 
command back to the 8540. The 8540 executes the 
command, perhaps accessing 8560 files in the process, 

This process is illustrated in Fig. 4-1. 



Precautions 

Because TNIX processes every line you enter in TERM 
mode, an OS/40 command line that is acceptable to an 
8540 in LOCAL mode will not necessarily be processed 
correctly in TERM mode. In TERM mode, for example, 
OS/40 command names must be entered in lowercase; the 
use of commas as delimiters is restricted; and certain 
characters that have special meaning to the TNIX shell 
must be "escaped" (made to appear non-special) so that the 
shell does not perform unwanted transformations on the 
command line. 



Summary 



An 8540/8560 TERM interface gives you simultaneous 
access to the 8540 and the 8560, and provides a 
convenient means for combining the resources of the two 
systems. For more information on the hardware configura- 
tions and software considerations of this interface, refer to 
the 8560 System Users Manual. 



COM INTERFACE 

The OS/40 COiv" comniand sets up communication 
between the 8540 and a host computer. To keep the 
interface as simple as possible, the 8540 uses the same 
RS-232-C-compatible communication protocol as a term- 
iani attached to the host. You use the parameters of the 
COM command to specify the protocol that is appropriate 
for ^our host. .A communications interface established via 
the COM command is referred to as a COM interface. 

NOTE 

Your 8540 must have the optional COM Interface 
Package installed in order to support a COM interface 
with any computer. Throughout the rest of this sec- 
tion, it is assumed that this COM option is installed in 
your 8540. 

The 8540 cannot execute the COM command while in 
TERM mode. 

Once you establish communication via the COM command, 
you can: 

• execute host commands from the 8540 system terminal 
just as if the 8540 weren't there; and 

• transfer data between the host and the 8540. 

The 8550 Microcomputer Development Lab and 8002A 
^/Processor Lab can also host COM interfaces with the 
8540. These special interfaces are discussed later in this 
section. 



system 
terminal 



command 



c 



response 



o 



8540 command 



file I/O (if needed) 



fO 



f>l 



8540 response 



(3936-22)3939-11 



Fig. 4-1. Command execution in TERM mode. 
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Types of Transfers 

Two categories of data transfers are possible with a COM 
interface: formatted and unformatted. Table 4-1 summarizes 
the types of formatted and unformatted transfers. 



the transfer of program symbols (for use in symbolic debug) 
and addresses of up to 64 bits. Both Tekhex formats are 
explained in detail in the subsection "8540/General Host 
Interface" later in this section. 



Formatted (Object Code) Transfers 

A formatted transfer copies blocks of object code in 
Tektronix Hexadecimal (Tekhex) format between a file on 
the host and program/prototype memory on the 8540. 
Checksums IntheTekhexformatpermitverificationofeach 
block of data as it is received. When you want to execute a 
program that you have created on the host, you use a 
formatted download to load the program into 8540 
program memory. 

There are two forms of Tekhex: Standard Tekhex, which is 
appropriate for microprocessors that address 64K of 
memory or less; and Extended Tekhex, which provides for 



Unformatted (File) Transfers 

An unformatted transfer copies data between a file on the 
host and an I/O device (such as a line printer or paper tape 
reader/punch) on the 8540. The data is transmitted and 
received with no error checking other than parity. 

A file may be transferred in ASCII mode or in binary mode. 
You use ASCII mode to transfer text files, and binary mode 
to transfer files of binary data. 

At this time, unformatted transfers are of limited use on the 
8540. 



Table 4-1 
Data Transfer Types 



Name 


Type of 
Data 


Type of 
Transfer 


Source 


Destination 


Host's^ 

Transfer 

Command 


8540's 

Transfer 

Sequence 


Formatted 
Download 


Object 
Code 


Tekhex 
to 
Binary 


Host File 


8540 
Program 
Memory 




(null) (cr) 


Formatted 
Upload 


Object 
Code 


Binary 
to 
Tekhex 


8540 
Program 
Memory 


Host File 




(null) 
addresses 
(cr)'' 


Unformatted 
ASCII 
Download 


ASCII 


Copy 


Host File 


8540 
Device 




(null) 
>device 
(cr) 


Unformatted 
Binary 
Download 


Binary 


Copy 


Host File 


8540 
Device 




(null) 
=device 
(cr) 


Unformatted 
ASCII 
Upload 


ASCII 


Copy 


8540 
Device 


Host File 




(null) 
<device 
(cr) 


Unformatted 
Binary 
Upload 


Binary 


Copy 


8540 
Device 


Host File 




(null) 
+device 
(cr) 



Fill in the commands that you use with your host. 

addresses— the starting and ending addresses of one or more blocks of program/prototype memory to be uploaded. The last pair of 
addresses may be followed by the transfer address of the program. 



(a) 
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Performing a Data Transfer 

YcLi initistss d3t3 transfsr b*' entering a command ! Ins that 
contains the following items: 

1 . a host-specific command that tells the hosttotransmit 
or receive the desired data (no carriage return here); 
and 

2. a sequence of characters that tells the 8540 what to 
transmit or where to put what it receives. This 8540 
transfer sequence begins with a null character and 
ends with a carriage return. The last column of Table4- 
1 gives the 8540 transfer sequence for each type of 
data transfer. 

Detailed descriptions of all six types of data transfers are 
given later in this section. 



The Null Character 

The null character (ASCII 00) is a special command line 
delimiter to an 8540 operating in a COM interface. The null 
character signifies that everything preceding it is a 
command to the host computer, and that everything 
following it (including the null itself) is a command to the 
8540. 

Characters entered at the terminal are transmitted directly 
to the host computer until the null is encountered. When a 
carriage return is entered at the end of a command line that 
contains the null character, the 8540 processes its portion 
of the command line, prepares to receive or send data, and 
then transmits the carriage return to the host. The host 
computer then processes the portion of the command line 
that was sent to it, and the data transfer takes place. (If you 
specified a special end-of-line character sequence with the 
EOL parameter of the COM command, that end-of-line is 
sent to the host in place of each carriage return.) 

On most terminals, the null character can be generated as 
a CTRL-@, that is, by pressing the CTRL key at the same 
time you press the keys needed to generate the @ symbol. 
In this section the null character is represented by (null). 
The null character is not displayed on the terminal. 

A null character can be sent from the 8540 terminal to the 



4... _„»».. 4.:. _..ll,s »^ 4.U, 



terminal. 



8540/8550 INTERFACE 

This subsection explains how to use an 8550 to host 
formatted (Tekhex) transfers with an 8540. (For informa- 
tion on how the 8550 hosts both formatted and 
unformatted transfers, refer to your 8550 System Users 
Manual.) When the 8550 is host, all communication 
procedures and data formats are handled automatically, so 
you do not need any special knowledge of Tekhex, the COM 



command, or communication protocols. For details on this 
type of information, refer to the "8540/General Host 



Intorfnro" Hicri iQQinn jatpr in thJR S<="^tinn. 



^} ex up 



To set up intersystem communication between an 8550 
and an 8540, you must connect an RS-232-C cable to the 
remote communication ports on the 8301 (jack J1 02) and 
the 8540 (jack J1 01). Set the MODE SELECT switches on 
the two systems to CNTL (L). Set the REMOTE BAUD 
switches to 2400. 



Establishing Communication 

When the physical connection has been established, you 
can initiate communication between the systems by first 
entering the COM commandonthe8540and then entering 
the HOST command on the host 8550. If you are 
performing one or more formatted uploads, and you want 
the object code to be stored in StandardTekhex ratherthan 
Extended Tekhex format, enter: 

> COM P=7E7E F=T <CR> 

Otherwise, enter: 

> COM P=7E7E <CR> 

The HOST command has no parameters. 



HOST Command Operation 

After you have entered the COM command on the 8540 
and the HOST command on the 8550, a message appears 
on the 8550 terminal that says 

HOST Vx.x 

and a message appears on the 8540 terminal that says 

Enter U or D; A, B, or H; aind 8550 filespec: 

At this point you are ready to initiate a data transfer. The 
discussion under "Data Transfers" describes how to 
perform both types of formatted transfers. While the HOST 
command is active, you cannot execute other DOS/50 
commands, and all input to both the 8540 and the 8550 is 
through the 8540's terminal. 



Exiting from HOST 



To exit from HOST, perform the following steps: 

1. Press the 8540 terminal's BREAK key to abort any data 
transfer that is taking place. 

2. Enter a null character and press the ESC key on the 
8540 to exit from the COM command. 

3. Type CTRL-C on the 8550 terminal to obtain the 
DOS/50 prompt. 
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4. Enter the command "A -A" (Abort All) on the 8550 
terminal. 

(CTRL-C) 
>> A -A <CR> 

Data Transfers 

The commands to initiate data transfers are entered on the 
8540 terminal in response to the prompts sent to the 8540 
terminal from the 8550. Two prompts are displayed. The 
first prompt is: 

Enter U or D; A, B, or H; emd 8550 filespec: 

This prompt requests information for the 8550 about the 
type and direction of the desired transfer: U (upload) or D 
(download); A (unformatted ASCII transfer), B (unformatted 
binary transfer), or H(Tekhex formatted transfer). The 8550 
filespec specifies the 8550 file to or from which the transfer 
is to take place. No embedded spaces are allowed between 
the parameters. 

After you have entered the requested information, the 
following prompt appears on the 8540's terminal: 

Enter transfer sequence, beginning 
with null character: 

This prompt requests information for the 8540. The null 
character indicates to the 8540 that the rest of the 
command line is a command to the 8540. 

The transfer command to the 8550 must match the transfer 
command to the 8540. 

NOTE 

i^heck the S550 system terrmndl for error messages 
after you initiate eacti transfer. The informational 
message "Error FF - End of file" appears after each 
successful transfer. 

After a transfer has been completed, there may be a delay 
of up to 30 seconds before the next prompt appears and the 
8550 is ready for another transfer. 

Formatted Download 

The following command sequence downloads a Tekhex 
load module to the 8540. The object code is placed in 8540 
program/prototype memory, and the program symbols, if 
any, are placed in the symbol table in 8540 system 
memory. 

Enter U or D ; A, B, or H; and 8550 filespec: 
DHfilespec <CR> 

D indicates to the 8550 that the transfer is a download. 
H indicates to the 8550 that the transfer is a formatted 
Tekhex transfer. 



filespec is the 8550's Tekhex file from which the data is to 
be transmitted. 

After you've entered this command line, you tell the 8540 
the type of transfer. 

Enter transfer sequence, beginning 

with null character: 
(null) <CR> 

(null) indicates that the rest of the command line is a 
command to the 8540. Since there are no commands 
following the null character, the 8540 recognizes that the 
transfer is a formatted download into program memory. 



Each time the 8550 sends a message block, an asterisk is 
displayed on the 8540's terminal. If the block is transferred 
correctly, the starting address and length of the block are 
displayed on the 8540 terminal. If the 8540 detects an error 
and issues a negative acknowledgement (NAK), the 8550 
resends the block and another asterisk is displayed on the 
8540 terminal. (If the 8540 has COM Version 4.1 or a later 
version, the 8540 displays an asterisk for each successfully 
transferred block and an underscore for each NAK.) 



When the transfer is complete, the 8540 terminal displays 
the initial prompt requesting information for the host 
computer: 

Enter U or D; A, B, or H; and 8550 filespec: 

and the 8550 terminal displays 

HOST: Error FF - End of file 



Formatted Upload 

The following command sequence uploads blocks of object 
code from 8540 program/prototype memory to a file on the 
8550. No program symbols are uploaded. 

Enter U or D; A, B, or H; and 8550 filespec: 
UHfilespec <CR> 

U indicates to the 8550 that the transfer is an upload. 

H indicates to the 8550 that the transfer is a formatted 

Tekhex transfer. 

filespec is the 8550 file to which the data is to be 

transferred. 



After you've entered this command line, you tell the 8540 
the type of transfer. 

Enter transfer sequence, beginning 

with null character: 
(null)lowaddl hiaddl lowadd2 



hiaddS 



transadd <CR> 
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(null) indicates that the rest of the command line is a 

command to the 8540. 

iniAiariri'i jg tKo JQww sddrsss of 3 bicck of S540 Drc^rsm 

memory to be transferred. 

hiaddl is the high address of a block of 8540 program 

memory to be transferred. 

l.^...».-J.*JO ;*> *U^ !«».. »^^ «^ —X *l Ul I- —X ncA/'\ 
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program memory to be transferred. 

hiadd2 is the high address of another block of 8540 

program memory to be transferred. 

transadd is the beginning execution address for the code in 

the transferred blocks. 

Each time the 8540 sends a block, the 8540 terminal 
displays 

*BLOCK SENT AT: address 

An asterisk is displayed each time a block is sent. If more 
than one asterisk appears, the 8550 has detected an error 
and issued a negative acknowledgement (NAK), and the 
block has been resent. 

When the transfer is complete, the 8540 terminal displays 
the initial prompt requesting information for the 8550: 

Enter U or D; A, B, or H; and 8550 filespec: 



8540/8002A INTERFACE 

This subsection explains how to use the TEKD05 SEND 
command to download a program from an 8002A 
/iProcessor Lab to 8540 program/prototype memory. The 
program must be in Standard Tekhex format, as produced 
by the TEKDOS WHEX command. 

For details about Tekhex, the COM command, and 
communications protocols, refer to the "8540/General 
Host Interface" discussion later in this section. 



Setup 



The 8002A and 8540 are connected via an RS-232-C line 
that runs from jack J101 on the 8002A rear panel to jack 
J102 (DTE) on the 8540 rear panel. On the 8540, be sure 
that the REMOTE BAUD switch is set to 2400 and that the 
MODE SELECT switch is set to CNTL (L). On the 8002A 
System Communication board, verify that the J1 jumper is 
set to the lower position, and that the P0RT1 baud rate 
jumper is set to 2400. 

Each system must have its own system terminal. 



and the 8550 terminal displays 

HOST: Error FF - End of file 



Troubleshooting 



Symptom 



Check 



Symptom 
Check 



Cannot establish initial communication. 

1 . Verify that the optional COM mterface 
software has been installed in your 8540. 

2. Verify that the transmit and receive 
baud rates of the 8550 and the 8540 
correspond. 

3. Verify that the RS-232-C cable is 
plugged into the correct jacks on the 
8550 and on the 8540. 

4. Verify that the switches controlling the 
REMOTE jacks on the 8301 and 8540 are 
positioned correctly. 



No reaction after typing transfer request. 

1 . Verify that your commands to the 8550 
and 8540 are appropriate, and that you 
are using the correct file name. 

2. Verify that when you entered the COM 
command on the 8540, you specified the 
appropriate prompt sequence (P=7E7E). 

3. On a formatted download, verify that 
the Tekhex file on the 8550 is in proper 
format. 



Establishing Communication 

To establish communication between the 8540 and the 
8002A, enter the following COM command on the 8540 
system terminal: 

> COM P=3F E=L L^I <CR> 

Then enter the SEND command on the 8002A system 
terminal: 

> SEND <CR> 

The SEND command does not issue any prompt. 



Performing a Download 

To download a "urogram from a Tekhex file on the 8002A, 
type the name of the file, a null character, and a carriage 
return on the 8540 terminal: 

filename (null) <CR> 

Each time the 8002A sends a message block to the 8540, 
an asterisk is displayed on the 8540 terminal. If the block is 
transferred correctly, the starting address and length of the 
block are displayed on the 8540 terminal. If the 8540 detects 
an error and issues a negative acknowledgement (NAK), the 
8002 A resends the block and another asterisk is displayed. 
(If the 8540 has COM Version 4.1 or a later version, the 
8540 displays an asterisk for each successfully transferred 
block and an underscore for each NAK.) When the 
download is complete, the 8540 terminal displays the mes- 
sage "ONLOAD:". 
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Terminating Communication 

To terminate communication between the 8540 and the 
8002A, perform the following steps: 

1 . If a download is in progress, press the BREAK key twice 
on the 8540 terminal. 

2. Enter a null character and press the ESC key on the 
8540 terminal. 



Troubleshooting 

Symptom Cannot establish initial communication. 

Check 1 . Verify that the optional COM interface 

software has been installed in your 8540. 

2. Verify that the RS-232-C cable is 
plugged into the correct jacks on the 
8540 and the 8002A. 

3. Verify that the REMOTE BAUD and 
MODE SELECT switches on the 8540 
rear panel are positioned correctly. 

4. Verify that the J1 jumper and P0RT1 
baud rate jumper are positioned correctly 
on the 8002A System Communication 
board. 

Symptom Unexpected reaction to download request. 



It is recommended that you make this host-specific 
information available to other users of your 8540, using the 
spaces provided at the end of this section and in the 
Operating Procedures section of this manual. 

This subsection is divided into the following topics: 

• Unformatted Transfers. Explains the protocols for 
unformatted transfers and identifies the types of host 
computer commands you can use to perform these 
transfers. 

• Formatted Transfers. Describes Standard and Extended 
Tekhex formats, explains the protocols for formatted 
transfers, and gives algorithms for programs to create, 
transmit, and receive Tekhex files. 

• The COM Command. Explains the parameters of the 
COM command. 

• Hardware Requirements. Describes the intersystem 
communication hardware on the 8540. 

• Establishing Communication. Tells how to connect the 
8540 to the host and establish communication. 

• Exiting from COM. Tells howto terminate communica- 
tion. 

• Data Transfers. Describes in detail howto perform each 
type of data transfer. 

• Troubleshooting. Describes possible communication 
problems and ways to solve them. 



Check 1. Verify that you entered the correct 

parameters for the COM command. 
2. Verify that the 8002A file you specified 
is in Standard Tekhex format. 



8540/GENERAL HOST 
INTERFACE 

This subsection provides the detailed information required 
to establish communication between an 8540 and a host 
computer that is not an 8560, 8550, or 8002A. Refer to the 
"COM Interface" discussion earlier in this section for a 
summary of the types of data transfers possible between 
the 8540 and a host. 

If you are sufficiently familiar with the way your host 
computer communicates with a terminal, you can use the 
information in this subsection to: 

• establish the appropriate RS-232-C connections and 
switch settings on the 8540 and the host 

• determine the parameters of the COM command line 
you will use to initiate communication with the host 

• determine the host command line that is appropriate for 
each type of data transfer 

• write programs for the host that create, transmit, or 
receive files in Tekhex format. 



Unformatted Transfers 

An unformatted transfer conveys data between a file on the 
host and an I/O device on the 8540. You cannot use an 
unformatted transfer for direct loading or dumping of 8540 
program memory. 

This discussion covers the utilities required on the host 
computer to accomplish unformatted transfers, the kinds of 
unformatted transfers, and protocols for unformatted 
transfers. 

Unformatted transfers are simpler than formatted transfers. 
In most cases, no special host computer software is 
required and standard host computer operating system 
utilities are used. 

Host Utility Requirements for Unformatted 
Transfers 

Two host computer utilities are required for unformatted 
transfers. These utilities must accomplish the following 
tasks: 

1 . For a download, the utility must be able to copy 
information from a file on the host computer to a 
terminal. 

2. For an upload, the utility must be able to copy 
information from a terminal to a file on the host 
computer. 
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Simple copy commands, text editors, and rapid text entry 
modes are examples of utilities that might be used. 



Kinds of Unformatted Transfers 



8540: ASCII uploads, ASCII downloads, binary uploads, 
and binary downloads. Table 4-2 shows the characteristics 
of each type of unformatted transfer. 

Table 4-2 
Characteristics of Unformatted Transfers 



Transfer 
Type 


Maximum 

Recommended 

Baud Rate^ 


Unit of 
Transfer 


Significant 

Bits Per 

Data Byte 


ASCII 
Upload 


2400 


ASCII line 


7b 


ASCII 
Download 


2400 


Entire file 


7b 


Binary 
Upload 


2400 


Entire file 


8 


Binary 
Download 


2400 


Entire file 


8 



^ Unformatted transfers may also proceed successfully at 4800 

or 9600 baud for some hosts. 
^ The high-order bit of each data byte is cleared by the 8540. 

Protocols for Unformatted Transfers 

With unformatted transfers, the transmitting computer 
does not receive confirmation that data was correctly 
received by the receiving computer. Instead, a prompt 
sequence (defined by the P parameter of the COM 
command) signals the 8540 that the host is ready for input 
(either more data or a new command). 

Upload Protocol. An unformatted upload transfers data 
from a device on the 8540 (such as the paper tape reader) to 
a file on the host, either line by line (ASCII upload) or as an 
uninterrupted stream of bytes (binary upload). 

\A/Korj +|^o iir^l/^orl lo /^r*rT^r»loto tKo QKAO r>rintc tKo moccsno 

RIOT: 

on the terminal, but does not transmit any end-of-file 
indicator. You must enter the appropriate end-of-file 
sequence when you see the RIOT: message, or the host 
must keep track of the time elapsed after each byte is sent 
and terminate the transfer when the 8540 appears to have 
stopped transmitting. 

ASCII Upload Protocol. In an unformatted ASCII upload, the 
host sends the prompt to the 8540 when the fiost is ready to 
receive a line of data. The 8540 then waits the amount of 



time indicated by the T parameter of the COM command 
and then sends the next line of data. Omit the P (prompt) 
parameter unless the host actually issues a prompt every 
time it is ready to receive a line. 

On the 8540, every carriage return (ASCII OD) in the data is 
assumed to be the end of a line, if you specify an end-of-line 
sequence with the EOL parameter of the COM command, 
the 8540 sends that sequence in place of each carriage 
return. 

The protocol for an unformatted ASCII upload is given in 
Fig. 4-2. 

Binary Upload Protocol. In an unformatted binary upload, 
the host sends the prompt (if any) to the 8540 when the 
host is ready to receive the data. The 8540 then waits the 
amount of time indicated by the T parameter of the COM 
command, and then sends the data to the host as an 
uninterrupted stream of bytes. 

The protocol for an unformatted binary upload is given in 
Fig. 4-3. 

Download Protocol. In an unformatted download, a file on 
the host is copied to an I/O device on the 8540 (such as the 
line printer). The host transmits the entire file without 
interruption, then sends the promptto indicatethatthe end 
of the file has been transmitted and that the host can accept 
input from the 8540. 



8540 


Host 




Prompt sequence 


Line 1 






Prompt sequence 


L i ne 2 






Prompt sequence 


Line n 




Terminate 


Terminate 


Transfer 


Transfer 



8540 


Host 




Prompt Sequence 


File Contents 




Terminate 


Terminate 


Transfer 


Transfer 



Fig. 4-3. Protocol for unformatted binary uploads. 
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For unformatted downloads. It is usually appropriate for the 
P (prompt) parameter of the COM command to match the 
host's system prompt. However, be sure that the prompt 
sequence you specify does not appear anywhere in the file 
to be downloaded, since the prompt marks the end of the 
data to be downloaded. 

The protocol for an unformatted download is given in Fig. 
4-4. 



8540 


Host 




Terminate 
Transfer 


File contents 

T 
Prompt sequence I 

M 
Terminate E 
Transfer * 



Fig. 4-4. Protocol for unformatted downloads. 3936 25 



Formatted Transfers 

A formatted transfer conveys object code between a file on 
the host and program/prototype memory on the 8540. The 
file may also contain program symbols to be placed in the 
8540's system memory for use in symbolic debug. 
Formatted transfers are more complex than unformatted 
transfers because the data must be put into predefined 
message blocks before it is transferred. The message 
blocks are structured according to the rules defining 
Tektronix Hexadecimal Format (Tekhex). 

This discussion covers the two types of Tekhex format, 
protocols for formatted transfers, and algorithms for 
software required on the host computer. 



3. a transfer address, which is the address where 
program execution should begin; and 

4. for use in symbolic debug, program symbols and their 
values. 

Extended Tekhex format can convey all four types of 
information, while Standard Tekhex conveys only the first 
three types. Both Tekhex formats also contain additional 
information, such as headers and checksums, which are 
used by the program that loads the object code. 

An 8540 or 8550 can accept a module that Is encoded in 
either format, or In a mixture of the two. An 8002A (or an 
8550 running DOS/50 Version 1 ) supports only Standard 
Tekhex. 

You need to use Extended Tekhex Instead of Standard 
Tekhex if any of the following conditions are true: 

• you need to specify a load address larger than FFFF; or 

• you need to convey symbols and symbol values for 
symbolic debug; or 

• you want to transmit more than thirty bytes of object 
code per block. 



Message Block Delimiters. A line of Tekhex information is 
referred to as a message block. Each message block begins 
with a slash (/ — for Standard Tekhex) or a percent sign 
(% — for Extended Tekhex) and ends with an end-of-line 
character sequence. Tektronix development systems use a 
single carriage return as an end-of-line. If your host 
computer uses a different end-of-line, it must be specified 
with the EOL parameter of the COM command, which is 
discussed later in thts section. 



Tektronix Hexadecimal Format (Tekhex) 

Standard Tekhex and Extended Tekhex are two ways of 
encoding a load module as lines of printable ASCII 
characters. A load module contains the following 
Information: 

1 . blocks of object code to be loaded Into memory; 

2. a load address for each block of object code that tells 
where In memory to load that block; 



Hexadecimal Digits. The letters A through F, when used 
as hexadecimal digits In Tekhex message blocks, must be 
uppercase. 
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Standard Tekhex 

Standard Tekhex uses three types of message blocks: 

1 . A data block contains object code. 

2. A termination block contains the transfer address and 
marks the end of the load module. 

3. .An abort block is used to terminate transmission when 
an unrecoverable error occurs. 



Data Blocks. A data block contains the load address for the 
object code in the block, a byte count, 30 or fewer bytes of 

data block is given in Table 4-3. 



uiSpiay H- 1 iS dfi example or a aata diock. 



Table 4-3 
Standard Tekhex Data Block Format 



Field 


Number of 

ASCII 
Characters 


Description 


/ 


1 


The slash specifies that the block is in Standard Tekhex format. 


Load 4 
Address 


The address where the object code is to be loaded (high-byte, low-byte format). 


Byte Count 


2 


Number of data bytes in the data field of the block. 


First 
Checksum 


1 

z. 


The Sum, mod 256, of the six hex digits of the load address and byte count. 


Data 


2n (2 to 60) 


n data bytes, each represented as two hex digits. Maximum of 30 data bytes. 


Second 
Checksum 


2 


Sum, mod 256, of the 2n hex digits of the data field. 



I — Load address 

I — First checksum 

— Second checksum 



IF U 



/010006070202020202020C 



Data 
' — Byte count 
Header 



Display 4-1. 



4-10 



Intersystem Communication — 8540 System Users 



Formatted Transfers 



Termination Blocks. A ternnination block contains only a 
transfer address (instead of a load address), a byte count of 
zero, and a checksum of the address and byte count. 
Because there is no data in the block, there is no second 
checksum. The format for a termination block is given in 
Table 4-4. 

Table 4-4 
Standard Tekhex Termination Block Format 



terminate the transmission. When this block is received, 
the message in the block is displayed on the 8540's 
terminal. The format for an abort block is given in Table 4-5. 

Table 4-5 
Standard Tekhex Abort Block Format 



Field 


Number of 

ASCII 
Characters 


Description 


/ 


1 


The slash specifies that the 
block is in Standard Tekhex 
format. 


Transfer 
Address 


4 


Starting execution address 
(high-byte, low-byte format) 
of the code transmitted in the 
data blocks. 


Byte 


2 


Always 00 in a termination 
block. 


Checksum 


2 


Sum, mod 256, of the six hex 
digits of the transfer address 
and byte count. 



Field 


Number of 

ASCII 
Characters 


Description 


/ 


1 


The slash specifies that the 
block is in Standard Tekhex 
format. 


/ 


1 


Another slash to identify the 
abort block. 


Message 


1 to 69 


A message to be displayed 
when the transfer is aborted. 



Display 4-2 is an example of a termination block. 

Abort Blocks. An abort block contains two slashes 
followed by a message. This block tells the 8540 that an 
unrecoverable transmission error has occurred and to 



Display 4-3 is an example of an abort block. 



Extended Tekhex 

Extended Tekhex uses three types of message blocks: 

1 . A data block contains object code. 

2. A symbol block contains information about a program 
section and the symbols associated with it. This 
information is needed only for symbolic debug. 

3. A termination block contains the transfer address and 
marks the end of the load module. 



I — Transfer address 
"Checksum 



If H 



/ 10000001 



■Byte count 



Header 



Display 4-2. 



Header 



Message 



/^ 



/5 CONSECUTIVE FAILURES. TRANSMISSION ABORTED 



Display 4-3. 
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NOTE 

Extended Tekhex has no specially defined abort 
block. To abort a formatted transfer, use a Standard 
Tekhex abort block, as defined earlier in this section. 

Each block begins with a six-character header field and 
ends with an end-of-!ine character sequence (on the 8540, 
a carnage return/. A biock can be up to ^.^-j Ci laracters lOng, 



not counting the end-of-line. A header field has the format 
shown in Table 4-6. 

Table 4-6 
Extended Tekhex Header Field 



Item 


Number of 

ASCII 
Characters 


Description 


% 


1 


A percent sign specifies that 
the block is in Extended 
Tekhex format. 


Block 
Length 


2 


The number of characters m 
the block: a two-digit hex 
number. This count does not 
include the leading % or the 
end-of-line. 


Block Type 


1 


6 - data block 

3 = symbol block 

8 = termination block 


Checksum 


2 


A two-digit hex number re- 
presenting the sum, mod 
256, of the values of all the 
characters in the block, except 
the leading %, the checksum 
digits, and the end-of-line. 
Table 4-7gives the values for 
all characters that may appear 
in Extended Tekhex message 
blocks. 



Table 4-7 
Character Values for Checksum Computation 



Characters 


Val 


ues (Decimal) 




0.9 




0..9 




A..Z 




10.35 




$ 




36 




% 




37 




. (period) 




38 




_ (underscore) 




39 




a.z 




40. 65 





Variable-Length Fields. In Extended Tekhex, certain fields 



O t^ 1 "7 <-> k> o r o ^+ r 



^ro^tioo 



enables you to compress your data by eliminating leading 
zeros from numbers and trailing spaces from symbols. The 
first character of a variable-length field is a hexadecimal 
digit that indicates the length oi the rest oi the iieid. me 
digit indicates a length of 16 characters. 

For example, the symbols START, LOOP, and KLUDGE- 
STARTSHERE are represented as 5START, 4L00P, and 
OKLUDGESTARTSHERE. The values 0, 100H, and FFOOOOH 
are represented as 10, 3100, and 6FF0000. 



Data and Termination Blocks. If you do not intend to 
transfer program symbols with your object code, you can do 
without symbol blocks. Your load module can consist of one 
or more data blocks, followed by a termination block. Table 
4-8 gives the format of a data block, and Table 4-9 gives the 
format of a termination block. 

Table 4-8 
Extended Tekhex Data Block Format 



Field 


Number of 
ASCII 

Characters 

1 


Description 

1 


Header 


6 


Standard header field. Block 
type = 6 


Load 
Address 


2 to 17 


The address where the object 
code is to be loaded: a 
variable-length number. 


Object 
Code 


2n 


n bytes, each represented as 
two hex digits. 



Table 4-9 
Extended Tekhex Termination Block Format 



Field 


Number of 

ASCII 
Characters 


Description 


Header 


6 


Standard header field. Block 
type = 8, 


Transfer 
Address 


2 to 17 


The address where program 
execution is to begin: a 
variable-length number. 



Display 4-4 is an example of a data block. 
Display 4-5 is an example of a termination block. 
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Block length: 15H = 21 

Checksum: 1CH = 28 = 1 +5+6+3+1 +0+0+0+2+0+2+. 
Object code: 6 bytes 



r 



%1561C3100020202020202 



Load address: 100H 
Block type: 6 
Header character 



Display 4-4. 



r 



Block length: 8 

Checksum: 1AH = 26 = 0+8+8+2+8+0 



%0881A280 



Transfer address: 80H 
Block type: 8 
Header character 



Display 4-5. 



Symbol Blocks. A symbol used in symbolic debug has the 
following attributes: 

1. the symbol itself: 1 to 16 letters, digits, dollar signs, 
periods, or underscores. The first character of the 
symbol can be a letter or (if the symbol is a section 
name) a percent sign. 

2. a value: up to 64 bits (16 hexadecimal digits). 

3. a type: address or scalar. (A scalar is any number that is 
not an address.) An address may be further classified 
as a code address (the address of an instruction) or a 
data address (the address of a data item). Symbolic 
debug does not currently use the code/data distinction, 
so the address/scalar distinction is sufficient for 
standard applications of Extended Tekhex. 

4. a global/local designation. This designation is of 
limited use in a load module, and is provided for future 
development. The concept of global symbols is 
discussed in the Assembler Core Manuals for 
TEKTRONIX A Series and B Series assemblers. If the 
global/local distinction is not important for your 
purposes, simply call all your symbols global. 



5. section membership. A section may be thought of as a 
named area of memory. Each address in your program 
belongs to exactly one section. A scalar belongs to no 
section. The concept of sections is discussed in detail 
in the Assembler Core Manuals for both A Series and B 
Series assemblers. The significance of sections with 
regard to symbolic debug is illustrated in the Learning 
Guide of this manual. 

The symbols in your program are conveyed in symbol 
blocks. Each symbol block contains the name of a section 
and a list of the symbols that belong to that section. (You 
may include scalars with any section you like.) More than 
one block may contain symbols for the same section. For 
each section, exactly one symbol block should contain a 
section definition field, which defines the starting address 
and length of the section. 

If your object code has been generated by an assembler or 
compiler that does not deal with sections, simply define 
one section called (for example) MEMORY, with a starting 
address of and a length greater than the highest address 
used by your program; and put all your symbols in that 
section. 
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Table 4-10 gives the format of a symbol block. Tables 4-1 1 
and 4-12 give the formats for section definition fields and 
symbol definition fields, which are parts of a symbol block. 

Table 4-10 
Extended Tekhex Symbol Block Format 



Field 


Number of 

ASCII 
characters 


Description 


Header 


6 


Standard header field. Block 
type = 3. 


Section 
Name 


2 to 17 


The name of the section that 
contains the symbols defined 
in this block: a variable- 
length symbol. 


Section 
Definition 


5 to 35 


This field must be present in 
exactly one symbol block for 
each section. This field may 
be preceded or followed by 
any ni.imher of symbo! defini- 
tion fields. Table 4-11 gives 
the format for this field. 


Symbol 
Definition(s) 


5 to 35 each 


Zero or more symbol defini- 
tion fields, as described in 
Table 4-1 2. 



Table 4-11 

Extended Tekhex Symbol Block: 

Section Definition Field 



Item 


Number of 

ASCII 
Characters 


Description 





1 


A zero signals a section 
definition field. 


Base 
Address 


2 to 17 


The starting address of the 
section: a variable-length 
number. 


1 o.-.,-,+ h. 

1 


O +« 1 T 


iii6 icngtii Oi tiic section: a 
variable-length number, com- 
puted as 1 + (high address - 
base address). 



Table 4-12 

Extended Tekhex Symbol Block: 

Symbol Definition Field 



Number of 



Item 


ASCII 
Characters 


Description 


Type 


A 


A hex digit that indicates the 
global/local designation of 
the symbol, and the type of 
value the symbol represents: 

1 = global address 

2 = global scalar 

3 = global code address 

4 = global data address 

5 = local address 

6 = local scalar 

7 = local code address 

8 = local data address 


Symbol 


2 to 17 


A variable-length symbol. 


Value 


2 to 17 


The value associated with the 
symbol: a variable-length 
number. 



Symbol Block Example. Suppose a section called 
SVCSTUFF occupies memory locations 40H-105H and 
contains the symbols shown in the following table, and that 
you don't care about global/local and code/data 
distinctions. 



■ 






Symbol 


Symbol 


Value 


Type 


Definition Field 


CR 


ODH 


scalar 


22CR1D 


OPEN 


50H 


address 


14OPEN250 


READ 


58H 


address 


14READ258 


WRITE 


60H 


address 


1 5WRITE260 


CLOSE 


68H 


address 


15CLOSE268 


EXIT 


70H 


address 


14EXIT270 


BUFLENGTH 


80H 


scalar 


29BUFLENGTH280 


BUF 


78H 


address 


13BUF278 



Display 4-6 shows how this information might be encoded 
in Extended Tekhex symbol blocks. (All this information 
could be encoded in a single 96-character block. It is 
divided into two blocks for purposes of illustration.) 
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r 



Block length: 37H = 55 

Checksum: 60H = (3+7+3+8+28+31+12+28+29+...) mod 256 

Section definition field: 

base address = 40H; length = C6H 



%373608SVCSTUFF02402C622CR1D140FEN25014READ25815WRITE260 
%373C88SVCSTUFF15CL0SE26814EXIT27029BUFLENGTH28013BUF278 



L_ 



Section name 
Block type: 3 
Header character 



Display 4-6. 



Protocols for Formatted Transfers 

Formatted transfers require a formal communications 
protocol. ASCII characters are used to positively acknow- 
ledge or negatively acknowledge the receipt of Tekhex 
nnessage blocks. The character "0" (ASCII 30H) is used as a 
positive acknowledgment (ACK) and the character "7" 
(ASCII 37H) is used as a negative acknowledgment (NAK). 
Each ACK or NAK is followed by an end-of-line. 



Upload Protocol. After the 8540 transmits a message 
block to the host, the host computer performs whatever 
error checking is desired. If no transmission error occurs, 
the host sends an ACK followed by a prompt to the 
transmitting 8540. The transmitting 8540 then continues 
with the formatted transfer by sending the next message 
block. If the host detects a transmission error, it responds 
by sending a NAK followed by a prompt to the transmitting 
8540. When the transmitting 8540 receives a NAK, it re- 
sends the message block that was incorrectly received. 
Figure 4-5 illustrates the protocol for a formatted upload. 



8540 


Host Computer 




Prompt sequence 




Message block 1 


ACK or NAK 
End-of-line 
Prompt sequence 




Message block 2 


ACK or NAK 
End-of-line 
Prompt sequence 


T 
I 
M 
E 


Message block n 


ACK or NAK 
End-of-line 
Prompt sequence 




Termination block 


ACK or NAK 
End-of-line 






Prompt sequence 1 


Terminate 


Terminate 




Transfer 


Transfer 
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Fig. 4-5. Protocol for formatted uploads. 
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Download Protocol. After the host sends a message biock 
followed by a prompt sequence to the receiving 8540, the 
receiving 8540 performs the appropriate error checking. If 
no transmission error occurs, the receiving 8540 responds 
by sending an ACK to the transmitting host. The host then 
continues with the transfer by sending the next message 
biock. if the receiving 8540 detects a transmission error, it 
responds by sending a NAK to the host. When the 
transmitting host receives a NAK, it re-sends the message 
block that was mcorrectly received. Fig. 4-6 illustrates the 
protocol for a formatted download. 

Suppressing Handshaking. The COM command param- 
eter HS = OFF eliminates the ACK/NAK response 
("handshaking") from the protocol of a formatted transfer. 
Eliminating handshaking simplifies a data transfer at the risk 
of undetected errors. In an upload, when the host receives a 
block, its response must consist only of the prompt se- 
quence if handshaking is off. in a dov\/nioad, the 8540 does 
not respond at all when it receives a block. However, the 
8540 still verifies each checksum, and if any are found to be 
incorrect, the 8540 issues an error message when the trans- 
fer is complete. In Version 4.1 and later versions, COM dis- 
plays an asterisk (signifying a good block) or an underscore 
(bad block) on the system terminal each time it receives a 
block, regardless of the HS parameter. 

Host Software Requirements for Formatted 
Transfers 

Because formatted transfers require a formal protocol, a 
host computer used with the 8540 must be capable of 



S540 


Host Computer 




! 




Message block 1 




Prompt sequence 






ACK or NAK 








End-of-line 


Message block 2 
Prompt sequence 






ACK or NAK 








End-of-line 




T 






Message block n 


I 






Prompt sennence 


M 




ACK or NAK 




E 




End-of-line 


Termination block 








Prompt sequence , 


' 




ACK or NAK 








End-of-line 








Terminate 


Terminate 






Transfer 


Transfer 
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Fig, 4-6. Protocol for formatted downloads. 



satisfying that protocol, in particular, the fuliowing 
programs are required on the host computer: 

1 . A transmit program that will transfer Tekhex blocks to 
the 8540. 

2. A receive program that will accept Tekhex blocks from 
the 8540. 

3. if you have object files in non-Tekhex format that you 
would like to transfer and use on the 8540, you must 
have a conversion program that will translate the 
object files into Tekhex format. 

Notice that without handshaking, the protocol for a 
formatted transfer is the same as for an unformatted ASCII 
transfer, as described earlier in this subsection. Therefore, 
a simple copy command could serve as a transmit or 
receive program. However, the 8540 generally takes longer 
to process a message block than the host requires to send 
the next one, so the transmit program must pause enough 
between lines that no data is lost. 

One way for the host to achieve the necessary delay is to 
transmit "fill" characters at the beginning of each message 

block COM fiiichoc nrQ/^occinn nna naocQanp hinrk uuhilp it 

receives (and ignores) the fill characters at the beginning of 
the next block. You may use any characters you want for fill, 
so long as they differ from the host's end-of-line 
characters(s) and from the leading character of the message 
block. For transfers at 2400 baud, four to six fill characters 
should be sufficient; the actual number required depends on 
your host and baud rate. 

Transmit Program. This program downloads Tekhex- 
formatted files to the 8540, using the download protocol 
described earlier in this section. The general algorithm is as 
follows: 

1 . Read a Tekhex block from a file (error checking for valid 
format is optional). 

2. Transmit the block followed by the predefined prompt 
sequence, and wait for an acknowledgement. The 
prompt sequence is defined in the COM command line, 
and the 8540 will not respond until it receives the 
prompt. 

3. If the reply is a negative acknowledgement (NAK): 

a. Increment the negative acknowledgement counter 
(this counter keeps track of how many successive 
transmission failures fiave ocCurreu). 

b. If the negative acknowledgement counter exceeds 
a maximum value that you have defined, terminate 
the transfer by sending an abort block, 

c. Prepare to re-transmit the block that was 
incorrectly received and go to step 2. 

4. If the reply is a positive acknowledgement (ACK): 

a. If the block sent was a termination block, terminate 
the transfer. 

b. Otherwise, go to step 1 . 
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This algorithm is presented in pseudo-code in Fig. 4-7. 



Receive Program. This program receives Tekhex files from 
the 8540, using the upload protocol described earlier in this 
section. The general algorithm is as follows: 

1 . Read a Tekhex block from the 8540. 

2. Verify proper format. A Standard Tekhex block must 
begin with a slash and must not exceed 71 characters 
in length (not counting the end-of-line). An Extended 
Tekhex block must begin with a percent sign and must 
not exceed 255 characters in length (not counting the 
end-of-line). 

3. If the block is a termination block, 

a. Verify the checksum. 

b. If an error is encountered, send a NAK followed by 
the pre-defined prompt sequence, and increment 
the NAK counter. 



c. If no error is encountered, write the block to a file, 
transmit an ACK followed by the predefined prompt 
sequence, and exit the receive program. 

If the block is not a termination block, 

a. Verify the byte count. 

b. Verify the checksum(s). 

c. If an error is encountered, increment the NAK 
counter and test to see if it exceeds a maximum 
value that you've selected. If it exceeds that value, 
terminate the transmission with an abort block; 
otherwise, send a NAK followed by the predefined 
prompt sequence to the 8540. The prompt 
sequence is defined in the COM command line, 
and is used by the 8540 to determine when the 
host computer is ready for input. 

d. If no error is encountered, write the block to a file 
and send an ACK followed by the predefined 
prompt-sequence to the 8540. 



END-OF-FILE = FALSE 
WHILE NOT END-OF-FILE 

READ TEKHEX BLOCK FROM FILE 

IF TEKHEX BLOCK IS A TERMINATION BLOCK THEN END-OF-FILE = TRUE 

NUMBER-OF-NAKS = 

GOODTX = FALSE 

REPEAT 

TRANSMIT BLOCK 

TRANSMIT PROMPT SEQUENCE 

GET REPLY 

IF REPLY IS AN ACK 

THEN GOODTX = TRUE 

ELSE 

NUMBER-OF-NAKS = NUMBER-OF-NAKS + 1 

IF NUMBER-OF-NAKS >= 5 

THEN 

TRANSMIT ABORT BLOCK 
GOODTX = TRUE 
END-OF-FILE = TRUE 
END 
END 
UNTIL GOODTX = TRUE 
END 
EXIT 
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Fig. 4-7. Algorithm for Tekhex transmit program. 
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This genera! algorithm is presented in pseudo-code in Fig. 
4-8. 



Conversion Programs. This discussion gives two algorith- 
nns for converting a file of object code into Tekhex format. 
The first algorithm is for conversion to Standard Tekhex, 



and the second is for conversion to Extended Tekhex. 
Because of the wide variation in object file formats from 
assembler to assembler, it is possible to give only very 
general algorithms. 



71 
255 



**N0 EEROR IN TERMINATION BLOCK=^ 



NAK-COW.'TER = 
END-OF-TRANSMISSION = FALSE 
WHILE NOT END-OF-TRANSMISSION 
CLEAR ERROR FLAG 

READ A TEKHEX BLOCK FROM THE RECEIVE LINE 
IF THE BLOCK STARTS WITH A "/" AND BLOCK-LENGTH < 
OR THE BLOCK STARTS WITH A "%" AND BLOCK-LENGTH < 
THEN 

IF BLOCK IS A TERMINATION BLOCK 
THEN 

VERIFY CHECKSUM 

IF ERROR 

THEN SET ERROR FLAG 

ELSE 

WRITE BLOCK TO FILE 
F,Nn-OF-TR_ANSMISSI0N = TRIJE 
TRANSMIT ACK, END-OF-LINE 
TRANSMIT PROMPT SEQUENCE 
END 
END 

IF BLOCK IS A NOT A TERMINATION BLOCK 
THEN 

VERIFY BYTE COUNT 
VERIFY CHECKSUM(S) 
IF ERROR 

THEN SET ERROR FLAG 

ELSE **N0 ERROR IN DATA OR SYMBOL BLOCK* 

WRITE BLOCK TO FILE 
TRANSMIT ACK, END-OF-LINE 
TRANSMIT PROMPT SEQUENCE 
NAK- COUNTER = 
END 
END 
END 
ELSE 

SET ERROR FLAG 
END 

IF ERROR FLAG SET 
THEN 

NAK- COUNTER = NAK- COUNTER + 1 
IF NAK-COUNTER >= NAK-LIMIT 

TRANSMIT ABORT BLOCK 
END-OF-TRANSMISSION = TRUE 
END 
ELSE 

TRANSMIT NAK, END-OF-LINE 
TRANSMIT PROMPT SEQUENCE 
END 
END 
END 
EXIT 



"BLOCK FORMAT IS BAD** 



ABORT THE TRANSMISSION** 
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Fig. 4-8. Algorithm for Tekhex receive program. 
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Standard Tekhex Conversion Program. 

1 . Discard any header information and scan for the first 
block of code. 

2. Read the block of code. 

3. If there are no more blocks: 

a. Generate a termination block. 

b. Stop execution, 

4. Strip off any non-object code information from the 
block. 

5. Check the block for valid input format. 

6. Start the output block with a slash. 

7. Immediately after the slash, append the 4-digit load 
address for the block. 

8. Determine the byte count n, where n is the number of 
bytes of object code in the block. Placethe byte count in 
the output block immediately following the load 
address. 



9. Calculate the first checksum as the sum of the 
individual hexadecimal digits of the load address and 
the byte count. Append this value immediately 
following the byte count. 

10. Put the n bytes of object code into the block, 
immediately following the first checksum. While 
performing this step, calculate the second checksum 
as the sum, mod 256, of the 2n hexadecimal digits in 
the object code. 

1 1 . Write the block to the output file. 

12. Go to step 2. 

This general algorithm is presented in pseudo-code in Fig. 
4-9. 



DISCARD HEADER INFORMATION 
END-OF-FILE = FALSE 
WHILE NOT END-OF-FILE 

READ BLOCK FROM INPUT FILE 

IF NO MORE BLOCKS 

THEN END-OF-FILE = TRUE 

ELSE 

IF BLOCK IS A TERMINATION BLOCK 
THEN 

SAVE TRANSFER ADDRESS FOR TEKHEX TERMINATION BLOCK 
END-OF-FILE = TRUE 
END 
ELSE 

SAVE LOAD ADDRESS 

STRIP NON OBJECT CODE INFOP>MATION FROM BLOCK 

CHECK FOR VALID FORMAT 

IF ERROR 

THEN 

OUTPUT ERROR MESSAGE 
END-OF-FILE = TRUE 
END 
ELSE 

OUTPUT -BLOCK [0 1 = "/" 
DETERMINE LOAD ADDRESS 

OUTPUT-BLOCK [1..4] = 4-DIGIT LOAD ADDRESS 
DETERMINE BYTE COUNT 

OUTPUT -BLOCK [5.. 6] = 2-DIGIT BYTE COUNT 
CALCULATE FIRST CHECKSUM 
OUTPUT-BLOCK [7.. 8] = 2-DIGIT CHECKSUM 
OUTPUT-BLOCK [9..2n+8] = OBJECT CODE 
CALCULATE SECOND CHECKSUM 

OUTPUT-BLOCK [2n+9 . .2n+10] = 2-DIGIT CHECKSUM 
WRITE OUTPUT -BLOCK TO FILE 
END 
END 
END 
END 

GENERATE TEKHEX TERMINATION BLOCK 
EXIT 
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Fig. 4-9. Algorithm for Standard Tekhex conversion program. 
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Extended Tekhex Conversion Program. This algorithm 
makes the following assumptions: 

• The object file may contain program syrnbois and 
section information as well as executable object code. 

• All the usable information in each block is output to the 
Tekhex file before the next block is read from the object 
file. (You may find it more useful to save the program 
symbols in a table as you proceed through the object file, 
and generate your symbol blocks from the symbol table 
at the end of the program.) 

• At most one data block and/or one symbol block is 
generated for each block read from the object file: there 
are no checks to verify that the maximum block length 
(255) has not been exceeded. 

• The variable n is used to represent the number of digits 
in a variable-length number. The value of n may be 
constant throughout the program, or it may be different 
for each number you encode (for example, if you choose 
to eliminate leading zeros). Similarly, the variable s 
represents the number of characters in a variable- 
length symbol. 

Here is the algorithm: 

1 . Discard any header information and scan for the first 
block of code or symbols. 

2. Read the block. 

3. If there are no more blocks: 

a. For every undefined section, generate a symbol 
block with a section definition field. 

b. Generate a termination block. 

c. Stop execution 



4. Strip off any extraneous information. 

5. Check the block for valid input format. 

6. If the block contains executable object code: 

a. Start the output block with a percent sign. 

b. Set the block type to 6 (data block). 

c. Place the load address in the block. 

d. Place the object code in the block. 

e. Determine the block length and checksum and put 
them in the block header. 

f. Write the block to the output file. 

7. If the block contains program symbols or section 
information: 

a. Start the output block with a percent sign. 

b. Set the block type to 3 (symbol block). 

c. Place the name of the section that contains these 
symbols in the block. 

d. If the base address and length of the section are 
available and have not been output previously, 
create a section definition field after the header 
field. 

e. For each symbol in the block, create a symbol 
definition field containing the symbol, its type, and 
its value. 

f. Determine the block length and checksum and 
place them in the block header. 

g. Write the block to the output file. 

8. Go to step 2. 

This algorithm is presented in pseudo-code in Fig. 4-10. 



DISCARD HEADER INFORMATION 
END-OF-FILE - FALSE 
WHILE NOT END-OF-FILE 

READ BLOCK FROM INPUT FILE 

IF NO MORE BLOCKS 

THEN ENTj-OF-FILE = TRUE 

ELSE 

IF BLOCK IS A TERMINATION BLOCK 
THEN 

SAVE TRANSFER ADDRESS FOR TEKHEX TEKMiNAlIuN BLOCK 
END-OF-FILE = TRUE 
END 
ELSE 

CHECK FOR VALID FORMAT 

IF ERROR 

THEN 

OUTPUT ERROR MESSAGE 
END-OF-FILE = TRUE 
END 
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Fig. 4-10. Algorithm for Extended Tekhex conversion program, (part 1 of 2) 
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ELSE 

IF BLOCK CONTAINS EXECUTABLE CODE 
THEN ** GENERATE DATA BLOCK** 
OUTPUT-BLOCK [0] = "%" 
OUTPUT-BLOCK [3] = "6" 
OUTPUT -BLOCK [6] = n 

OUTPUT-BLOCK [7..6+n] = n-DIGIT LOAD ADDRESS 
OUTPUT-BLOCK [7+n. .6+n+2m] = m BYTES OF OBJECT CODE 
OUTPUT-BLOCK [I.. 2] = 6+n+2m **2-DIGIT BLOCK LENGTH** 
OUTPUT-BLOCK [4.. 5] = 2-DIGIT CHECKSUM 
WRITE OUTPUT -BLOCK TO FILE 
END 
F BLOCK CONTAINS SYMBOLS OR SECTION INFORMATION 
THEN ** GENERATE SYMBOL BLOCK** 
OUTPUT-BLOCK [0] = "%" 
OUTPUT-BLOCK [3] = "3" 
OUTPUT -BLOCK [6] = s 

OUTPUT-BLOCK [7..6+s] = s-CHARACTER SECTION NAME 
p = 7+s **p POINTS TO NEXT AVAILABLE SPOT IN OUTPUT-BLOCK*" 
IF SECTION NOT ALREADY DEFINED 

THEN IF BASE ADDRESS AND LENGTH ARE AVAILABLE 

THEN **GENERATE SECTION DEFINITION FIELD** 
OUTPUT -BLOCK [p] = "0" 
OUTPUT-BLOCK [p+1] = n 

OUTPUT-BLOCK [p+2..p+l+n] = n-DIGIT BASE ADDRESS 
p = p+n+2 

OUTPUT -BLOCK [p] = n 

OUTPUT-BLOCK [p+l..p+n] = n-DIGIT SECTION LENGTH 
p = p-m+l 

MARK SECTION AS DEFINED 
END 

ELSE MARK SECTION AS UNDEFINED 
**GENERATE SYMBOL DEFINITION FIELDS** 
FOR EACH SYMBOL 

SYMBOL TYPE 



OUTPUT -BLOCK [p] 

OUTPUT-BLOCK [p+1] = s 

OUTPUT-BLOCK [p+2..p+l+s] 

p = p+s+2 

OUTPUT -BLOCK [p] = n 

OUTPUT -BLOCK [p+l..p+n] 

p = p+n+1 
END 

OUTPUT-BLOCK [1..2] = p-1 **2-DIGIT BLOCK LENGTH* 
OUTPUT-BLOCK [4.. 5] = 2-DIGIT CHECKSUM 
WRITE OUTPUT-BLOCK TO FILE 



-CHARACTER SYMBOL 



n-DIGIT VALUE 



END 



END 



END 



END 
END 
FOR EACH UNDEFINED SECTION 

GENERATE SYMBOL BLOCK WITH SECTION DEFINITION FIELD 
GENERATE TEKHEX TERMINATION BLOCK 
EXIT 
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Fig. 4-10. Algorithm for Extended Tekhex conversion program, (part 2 of 2) 
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The COM Command 

The COM command specifies the details of the 
communication protocol that the 8540 is to use with your 
host computer. This discussion explains the parameters of 
the COM command. 

All COM parameters are optional and may be entered in 
any order and in any combination that wiii taiior the 
response of the S540 to the host computer. 

Echo Parameter (E=) 

This parameter selects remote or local echoing of 
characters entered from the 8540 system terminal. E=R 
(remote echo) indicates that the host computer echoes the 
characters entered from the 8540 system terminal. E=L 
(local echo) indicates that the host computer does not echo 
characters entered from the 8540 system terminal, and 
thus the echo must be provided locally (by the 8540). The 
default value is E=R. 

Linefeed Parameter (L=) 



Thic r*aram£i+Qr olly-^i 



LCI iiiii lai i(j II loiuue 



or omit a linefeed on the system terminal after a carriage 
return is sent to the terminal. L=l (include linefeed) 
indicates that the host computer does not output a linefeed 
to the terminal after a carriage return is entered, so the 
8540 supplies the linefeed. L=0 (omit linefeed) indicates 
that the host computer sends a linefeed to the terminal 
after a carriage return is entered. The default value is L=0. 

Prompt Parameter (P=) 

This parameter specifies the prompt sequence used by the 
host computer communicating with the 8540. The prompt 
sequence represents the characters that the host computer 



sends when it is ready to receive data. This is not 
necessarily the system prompt of the host computer. The 
default value for this parameter Is no prompt sequence. If 
you omit the prompt parameter, the 8540 does not wait to 
receive a prompt sequence from the host computer before 
sending data. 

The prompt sequence consists of an even number of up to 
32 hexadecimal digits, representing up to 16 ASCII 
characters. You may not enter spaces between the digits. 

The 8540 ignores the prompt sequence except during data 
transfers. 



Turnaround Delay Parameter (T=) 

Some computers require a delay between displaying their 
prompt sequence and accepting input. The turnaround 
delay parameter allows you to ensure that, after receiving 
the prompt sequence from the host, the 8540 will wait for 
the appropriate amount of time before it sends a reply. 

The T parameter has a range of 00 to FF (hexadecimal), 
where each unit has a value of 100 milliseconds. For exam- 
ple, T=04 sets the turnaround delay to 400 milliseconds. 
The default value for this parameter is T=00. (For COM 
Version 4.1 and later versions, the delay is specified in 10- 
millisecond units, so T=04 represents 40 milliseconds.) 

Character Transmission Format {M=) 

This parameter specifies the character transmission 
format required by the host computer when it receives or 
transmits data. Table 4-13 lists the transmission 
characteristics corresponding to values for M. The default 
value for this parameter is M=4. 



Table 4-13 
Character Transmission Formats Corresponding to Values for M 



M 


Start 
Bits 


Stop 
Bits 


Data 
Bits 

L. .... , _, , 


Significant 
Bits 


Parity 


Parity 
Bits 


Total 

Transmitted 

Bits 







2 


7 


7 


even 


1 


11 


1 




2 


7 


7 


odd 


1 


11 


2 




1 


7 


7 


even 


1 


10 


3 




1 


7 


7 


odd 


1 


10 


4 




2 


8 


7 or 8' 


none 





11 


5 




1 


8 


7 or 8' 


none 





10 


6 




1 


8 


7 or 8' 


even 


1 


11 


7 


^ 


1 


8 


7 or 8' 


odd 


1 


11 



High-order bit is set to by the 8540 in ASCII transfers. 
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Error Check Parameter (C=) 

This parameter allows you to override the COM error 
checking facilities on the remote communication port. If 
you specify C=l (ignore errors), the 8540 ignores any 
condition that causes a communication error, and 
continues execution. If you enter C=T (terminate on error), 
control leaves COM and passes to OS/40 if any 
communication error occurs. The default value for this 
parameter is C=T. 



Load Module Format (F=) 

This parameter specifies the message block format to be 
used in formatted uploads. If this parameter is omitted, 
blocks are transmitted in Extended Tekhex format. F=T 
specifies Standard Tekhex format. COM accepts message 
blocks in either Tekhex format, regardless of the F 
parameter. 



End-of-Line Parameter (EOL=) 

This parameter specifies the character sequence used by 
the host to mark the end of a line of text, such as a host 
command, a line of ASCII data, or a Tekhex message block. 

The character sequence is specified as an even number of 
up to 32 hexadecimal digits, representing 16 characters. 
The default end-of-line parameter is EOL=0D (a carriage 
return). 



Character Substitution Parameter (SUB 
xx=yy) 

This parameter specifies one or more character substitu- 
tions to be performed by COM on data transmitted to or 
from the host. Each substitution construct consists of a pair 
of character codes (represented as two-digit hexadecimal 
numbers) separated by an equal sign. When the first charac- 
ter Is received from the host, COM substitutes the second 
character. When the second character is to be sent to the 
host, COM substitutes the first. Multiple substitution con- 
structs can be strung together, separated by slashes — 
SUB 74=24/75=25/78=30, for example. 



Byte Count Parameter (B=) 

This parameter specifies the number of bytes of object code 
that COM will place In each data block during formatted 
uploads. (Each byte is encoded as two hexadecimal digits.) 
This parameter is supported only for COM Version 4.1 and 
later versions. This parameter is ignored if you specify F=T. 
The byte count is specified as a two-digit hexadecimal num- 
ber in the range 01-76. The default count is 20 (32 decimal). 
Any number outside the range 01-76 yields a byte count of 
76 (118 decimal). 



Hardware Requirements 



Handshaking Parameter (HS=} 

The parameter HS=OFF eliminates the ACK/NAK 
response from the protocol of a formatted transfer. In a 
download, COM normally responds with an ACK or NAK 
each time it receives a message block from the host. When 
handshaking is OFF, COM gives no response. However, 
checksums are still computed and checked, and if any are 
found to be incorrect, COM issues an error message when 
the transfer is complete. In an upload, COM expects no 
ACK/NAK response from the host. 

Turning off handshaking has no effect on the P (prompt 
sequence) and T (turnaround delay) parameters. COM still 
looks for the host's prompt sequence (if any) and waits the 
indicated turnaround delay (if any) before continuing. 



General Information 

The 8540 I/O device for intersystem communication is an 
ACIA (Motorola 6850 Asynchronous Communication 
Interface Adapter) connected to REMOTE jacks J101 and 
J102 on the back of the 8540. Both jacks are RS-232-C 
compatible; these are the only jacks for which COM 
interface procedures are implemented. 

Jack J101 is a 25-pin male plug designed as an interface 
for data terminal equipment (DTE). Jack J102 is a 25-pin 
female plug designed as an interface for data communica- 
tion equipment (DCE). The jack you select and the setting of 
the MODE SELECT switch on the 8540 rear panel 
determine how the 8540 uses the various RS-232-C 
signals. See Table 4-14. 
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Table 4-14 
Signals at 8540 Remote Port 





Jack J101 (DTE) 
MODE SELECT 
Switch Setting 


Jack J102 (DCE) 
MODE SELECT 
Switch Setting 


Signal 
Description 


DTE1 


DTE2 CNTL (L) 


DCE 


CNTL {L) 


Pm 1— GRD 


Protective Ground 


Pin 2— TX 


Output: Data 
from 8540 


Output: Data 
from 8540 


Output: Data 
from 8540 


Input: Data 
from external 
computer 


Input: Data 
from external 
computer 


Pin 3— RX 


Input: Data 
from external 
computer 


Input: Data 
from external 
computer 


Input: Data 
from external 
computer 


Output: Data 
from 8540 


Output: Data 
from 8540 


Pin 4— RTS 


Output: Goes 
high when 8540 
has data to send 


Output: Goes 
high when 8540 
has data to send 


Output: Always 
high 


Input: Must be 
high before 8540 
accepts data 


Input: Ignored 


Pin 5-CTS 


Input: Must be 
high before 8540 
sends data 


Input: Ignored: 


Input: Ignored 


Output: Goes 
low when 8540 
sends data 


Output: Always 
high 


Pin 6— DSR 


Input: ignored: 


Input: Must be 
high before 8540 
sends data 


Input: Ignored 


Output: Always 
high 


Output: Always 
high 


Pin 7-GRD 


Signal Ground 


Pin 8— DCD 


Input: Must be 
high before 8540 
accepts data 


Input: Must be 
high before 8540 
accepts data 


Input Ignored 


Output: Always 
higti 


Output: Always 
high 


Pm 20— DTR 


Output Always 

high 


Output: Always 
hsgh 


Output: Always 
h,gh 


Input: Must be 
high before 8540 
sends data 


Input: Ignored 



The type of equipment you have determines which jack you 
will use. In general, if the external computer's RS-232-C 
I/O port hasafemaleplug, you'll use jack J101 onthe8540 
and set the MODE SELECT switch to DTE1 or DTE2. If the 
external computer's I/O jack has a male plug, you'll use 
jack Jl 02 on the 8540 and set the MODE SELECT switch to 
CNTL (L) or DCE. 



Baud Rate 

The baud rate at which the REMOTE jacks operate is switch 
selectable from 1 1 baud to 9600 baud. The baud switch is 
located immediately to the right of jack J102 on the 8540 
rear panel. 

The maximum recommended transfer rate for an unformat- 
ted transfer is 2400 baud. Formatted transfers should pro- 
ceed successfully at up to 9600 baud, depending on the 
limitations of the host. 



Modem Considerations 

When using a modem to connect the 8540 with an external 
computer, be sure that the modem is operating in full 
duplex mode. 



Remote Port Status Register 

An 8-bit status register is associated with the ACIA device. 
When you are not transferring files, you can display the 
contents of the status register by entering the command 
line 

(null)S <CR> 



The 8540 will respond with a 2-digit hexadecimal number 
representing the status of the ACIA. Table 4-15 describes 
what each of the bits in the status register represents. 
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Table 4-15 
Remote Port Status Register Bits 



Bit 








No.^ 


Set by 


Cleared by 


Use 





Byte received 


Reading 


Determine 




by ACIA. 


received byte 


whether byte 






in ACIA. 


received. 


1 


Byte moved 


Writing byte 


Determine 




to ACIA 


into transmit 


whether 




shift-out 


data register. 


transmit data 




register. 




register 
ready for 








next byte. 


2 


Data carrier 


Carrier signal 


Test of com- 




signal lost. 


detected at 


munications 




No connection 


ACIA. 


connection. 




at REMOTE 








port. 






3 


Incoming 


Incoming 


Determine 




CTS signal 


CTS signal 


whether 




low. 


high. 


external 
device is 
ready to 
receive data. 


4 


Byte in ACIA 


Reading byte 


Test for 




has error in 


or receiving 


valid data 




stop bits 


next byte 


byte. 




(framing 


from remote 






error). 


communica- 
tion port. 




5 


Byte received 


Reading 


Test for 




from external 


received data 


fost data. 




device ahd 


byte 






previous byte 








not yet read. 








Previous byte 








IS overwritten. 






6 


Parity error 


Reading 


Test for a valid 




in received 


current byte 


data byte. 




byte. 


or receiving 
next byte. 




7 


Transmit data 


For a transmit 


Test for 




register 


interrupt, 


occurrence of 




empty or 


writing the 


interrupts. 




receipt of byte 


next byte 






byte into 


clears the 






ACIA and 


interrupt. For 






interrupt 


a receive 






enabled. 


interrupt, 
reading 
the received 
byte clears 
the interrupt. 





Establishing Communication 

To prepare the 8540 for operation with a host computer, 
you must first establish a physical connection between the 
two computers. To do this, plug one end of an RS-232-C 
cable into a host computer RS-232-C compatible terminal 
port. Connect the other end of the RS-232-C cable to the 
REMOTE port on the 8540 rear panel. (Refer to the 
"Hardware Requirements" discussion earlier in this 
subsection to determine which jack and MODE SELECT 
switch setting are appropriate.) 

Now use the COM command to establish communication 
with the host. After you have established initial 
communication, the 8540 acts as a terminal to the host. 
You can now transfer data to and from the 8540: see the 
following discussion of "Data Transfers." 



Exiting from COM 



Bit number 7 is the most significant bit. 



When the 8540 is acting as a terminal to the host, you may 
exit the COM subsystem at any time by entering the 
command 

(null) (escape) 
where (escape) is the ESC key on your terminal. 

If you are performing a transfer and want to exit the COM 
subsystem, you must first abort the transfer by pressing the 
BREAK key. This will cause the 8540 to resume acting as a 
terminal to the host. You can then exit COM by entering 
(null)(escape). 



Data Transfers 

Once your 8540 is acting as a terminal to the host 
computer, you can initiate the transfer of data between the 
two computers. The general format for uploading and 
downloading data is given in thefollowing paragraphs. You 
can abort a data transfer at anytime by pressing the BREAK 
key on the 8540 system terminal. 

Formatted Transfers 

The following procedures transfer data between Tekhex 
files on the host and program/prototype memory in the 
8540. 

Formatted Download. The following command line 
downloads a Tekhex load module to 8540 program/ 
prototype memory. Program symbols in the load module 
are placed in the 8540's symbol table, for use in symbolic 
debug. 

host-connnanci(null) <CR> 



(n) 
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host-command is the host computer command to initiate 

the execution of your host computer program for formatted 

downloads. 

^null) indicates that the rest of the command line is a 

command to the 8540. Since there is no command 

following the null character, the 8540 recognizes that the 

transfer is a formatted download. 

With COM Version 4.1 and later versions, COM displays an 
asterisk on the system terminal and sends an ACK to the 
host each time a block is received successfully. If the block 
contains errors, COM displays an underscore and sends a 
NAK to the host. 

In earlier versions, COM displays an asterisk each time it 
receives a block. If the block contains errors, COM sends a 
NAK to the host; otherwise COM sends an ACK and dis- 
plays the load address and byte count of the block. 

When COM receives a symbol block successfully, it reports 
the section name to the system terminal. If the block con- 
tains errors, COM may store erroneous symbols or values in 
the symbol table before detecting the error. If you see COM 
NAK in a symbol block, beware of errors in the symbol table. 
You may need to reSELect the emulator (to clear the symbol 
table) and download the file again. 

When the transfer is complete, the following message 
appears on the 8540 system terminal: 

ONLOAD: 

Formatted Upload. The following command line uploads 
selected blocks of 8540 program/prototype memory to the 
host in I eknex format, 
host-command ( null )lowaddl hiaddl 



lowaddS hiadd£ 



transadd <CR> 



host-command is the host computer command that 

initiates the execution of your host computer program for 

formatted uploads. 

(null) indicates that the rest of the command line is a 

command to the 8540. 

lowaddl is the low address of a block of 8540 program 

memory to be transferred. 

hiaddl is the high address of a block of 8540 program 

memory to be transferred. 

lowadd2 is the low address of another block of 8540 

program memory to be transferred. 

hladd2 is the high address of another block of 8540 

program memory to be transferred. 

transadd is the beginning execution address for the code in 

the transferred blocks. 

No program symbols are uploaded from the 8540. 

When the transfer is complete, the following message 
appears on the 8540 system terminal: 

UPLOAD: 



Unformatted Transfers 

The following procedures copy data between files on the 
host and I/O devices connected to the 8540. 

Unformatted ASCII Download. Here is the command 
syntax for an unformatted ASCII download: 

host-command(null ) >device <CR> 

host-command is the host computer commandtodisplaya 

text file on the terminal. 

(null) indicates that the rest of the command line is a 

command to the 8540. 

> indicates that the transfer is an unformatted ASCII 

download. 

device is the 8540 device (for example, LPT) to which the 

downloaded data is to be written. 

When the transfer is complete, the following message 
appears on the 8540 system terminal: 

RIOT: 

Unformatted Binary Download. Here is the command 
syntax for an unformatted binary download: 

host-command(null) =device <CR> 

host-command is the host computer command to dump a 

binary file to the terminal. 

(null) indicates that the rest of the command line is a 

command to the 8540. 

= indicates that the transfer is an unformatted binary 

download. 

device is the 8540 device (for example, PPTP) to which the 

binary data is to be written. 

When the transfer is complete, the following message 
appears on the 8540 system terminal: 

RIOT: 

Unformatted ASCII Upload. Here is the format for an 
unformatted ASCII upload from the 8540 to the host 
computer: 

ho3t-commaj\d(null) <device <CR> 

host-command is the host computer command that reads 

text from the terminal and transfers the input to a file on the 

host. 

(null) indicates that the rest of the command line is s 

command to the 8540. 

< indicates that the transfer is an unformatted ASCII 

upload. 

device is the name of the 8540 device (for example, PPTR) 

that provides the data to be transferred to the host 

computer. 

When the transfer is complete, the following message 
appears on the 8540 system terminal: 

RIOT: 
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Troubleshooting 



The 8540 does not send an end-of-f ile message to the host. 
When you see the RIOT: message, enter your host's end-of- 
file character at the system terminal. 

Unformatted Binary Upload. Here is the format for an 
unformatted binary upload from the 8540 to the host 
computer: 

host-coiiimand(null)+device <CR> 

host-command is the host computer command that reads 

binary data from the terminal and transfers the input to a 

file on the host. 

(null) indicates that the rest of the command line is a 

command to the 8540. 

+ indicates that the transfer is an unformatted binary 

upload. 

device is the name of the 8540 device (for example, PPTR) 

that provides the data to be transferred to the host 

computer. 

When the transfer is complete, the following message 
appears on the 8540 system terminal: 

RIOT: 

The 8540 does not send an end-of-f ile message to the host. 
When you see the RIOT: message, enter your host's end-of- 
file character at the system terminal. 

Troubleshooting 

Establishing Initial Communication 

Symptom Cannot establish initial communication. 



Check 



Symptom 



Check 



1 . Verify that the optional COM interface 
software has been installed in your 8540. 

2. Check the COM command line for 
correct syntax. Be sure that the para- 
meters were specified correctly. 

Cannot log on or communicate with host 
computer. 

1. Check the REMOTE port baud rate 
switch on the 8540 rear panel. The rate 
selected must match that of the modem 
or output port of the host computer. 

2. Verify that the MODE SELECT switch is 
set properly for operation with your 
equipment. 

3. Check all RS-232-C control signals/ 
lines in the interface. 

4. Verify the connection to the correct 
8540 rear panel REMOTE port, J101 or 
J102. 

5. Be sure that the M parameter in the 
COM command corresponds to the host 
computer's data transmission format. 

6. Exit from COM and return to OS/40 by 



Symptom 



Check 



entering (null)(escape) on the 8540's 
terminal. Then restart the system. 



Random characters displayed on the 
terminal, or improper display when 
attempting to log on to the host computer. 



1 . Check for proper baud rate selection on 
the 8540 rear panel REMOTE port. 

2. Be sure that the M parameter in the 
COM command corresponds to the host 
computer's data transmission format. 



Attempting a Formatted Download to the 
8540 

Symptom No reaction after typing download trans- 

fer request. 

Check 1. Check the download transfer request 

for compatability with the required host 
computer command. 
2. If E=R was specified in the COM 
command, check to see if the host 
computer is echoing all carriage returns 
sent to it. If the host computer does not 
echo the carriage returns at the end of 
the downloadtransfer request command, 
the 8540's download routine will not 
execute properly. 

Symptom Host computer's download program is 

inoperative. 

Check 1. Check the download program I/O 

assignments. If the program output is not 
assigned to the terminal corresponding 
to the line to the 8540, the 8540 will not 
receive the output. 

2. Verify that the download command 
line ended with a null character. 

3. Verify that the download program in 
the host computer is actually starting 
execution. 

4. Verify that the file being downloaded is 
in Tekhex format. 

5. Verify that the host computer is 
sending an end-of-line sequence (as 
specified by the EOL parameter of the 
COM command) at the end of each 
Tekhex block. 

Symptom Download program transmits one or 

more blocks and then hangs up. 
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Check 



Symptonn 



Check 



1. Verify that the prompt sequence was 
correctly specified in the COM command. 

2. Test the download program by omitting 
the null character from the command line 
used to start the download. The output 
from the host computer should now be 
displayed on the terminal. Enter positive 
and negative acknowledgments manu- 
ally and step the program through the 
download sequence. 

3. Verify that the turnaround delay 
parameter, T, is correctly specified in the 
COM command. 



The 8540 repeatedly sends negative 
acknowledgments for the first block and 
causes the download program to abort. 

1. Verify that the Tekhex block contains 
the correct checksum(s). 



2. Verify that the byte count logic in the 
host computer upload program is correct. 

3. Verify that the checksum logic in the 
host computer upload program is correct. 

4. Verify that the input buffer in the host 
upload program is of sufficient length. 



Attempting an Unformatted ASCII or 
Binary Download to the 8540 

No reaction after typing download transfer 
request. 



Symptom 



Check 



1 . Verify that the host computer's portion 
of the command is a valid host-computer- 
to-terminal copying command. 

2. Verify that the 8540's portion of the 
command has no embedded spaces and 
is of the form 



Attempting a Formatted Upload from the 
8540 

Symptom No reaction after typing transfer request. 

Check 1 . Verify that the transfer request 

command was entered correctly. 
2. If E=R was specified in the COM 
command, check to see if the host 
computer is echoing all carriage returns 
sent to it. If the host computer does not 
echo the carriage returns at the end of 
the download transfer request command, 
the 8540's upload routine will not 
execute properly. 

Symptom Host computer's upload program is 

inoperative. 

Check 1. Verify that the prompt sequence was 

correctly specified in the COM command. 
2. Verify that the upload program on the 
host computer is sending a positive or 
negative acknowledgement after the first 
message block is received. 

Symptom The upload program on the host computer 

repeatedly sends negative acknowledge- 
ments, and eventually aborts. 

Check 1. Verify that the protocol in the host 

computer upload program is correct. 



Check 



(null)>device <CR> (ASCII) 

or 

(null)=device <CR> (binary) 

3. If using a modem, check to see if any 
data is being received by the modem. 

4. All of the data may have been 
transmitted, but the 8540 may not have 
received the the end-of-transmission 
prompt. Recall that a unique prompt 
sequence must be transmitted after the 
file has been transmitted. That prompt 
sequence must match the prompt se- 
quence that you defined when you 
entered the the COM command. If the 
8540 is waiting for the end-of-transmission 
prompt, you can manually exit the transfer 
process by pressing the BREAK key. 

L/uVviiiCau ucLjiiiS, uui ai Sunic puiiii iHc 

file Starts appearing on the 8540 system 
terminal. 

1 . Verify that the prompt sequence that 
you defined when you entered the COM 
command appears only at the end of the 
file to be downloaded. If the prompt 
sequence appears anywhere within the 
body of the file to be transferred, the 
8540 will stop writing information to the 
selected device and start writing infor- 
mation to the system terminal. 
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Troubleshooting 



Attempting an Unformatted ASCII or 
Binary Upload from the 8540 

Symptom No reaction after typing upload transfer 

request. 

Check 1 . Verify that the host computer's portion 

of the command is a valid terminal-to- 
host-computer transfer command. 
2. Verify that the 8540's portion of the 
command has no embedded spaces and 
is of the form 

(null)<device <CR> (ASCII) 



(null)+device <CR> (binary) 

3. Verify that the prompt sequence 
specified in the COM command is 
correct. If you specify a prompt sequence 
on an ASCII upload, the host must 
respond with that prompt every time it 
receives a line from the 8540. 

4. Verify that a valid 8540 device was 
specified as the source of the upload. 

5. Restart the 8540. 



Commands for Intersystem 
Communication 

These spaces are provided for you to write the command 
sequences that you will use with your 8540 and your host 
computer. 

Establishing Initial Communication 



Formatted Download 



Formatted Upload 



Symptom Partial data transfer with the loss of the 

first part of the data. Also, large gaps in 
the received file. 

Check 1. Verify that the turnaround delay 

parameter, T, is big enough. If the T 
parameter was not specified, it may have 
to be specified to prevent loss of the 
beginning of the data. Insufficient turn- 
around delay causes the loss of an initial 
portion of each transmission made. 
2. Verify that the proper P (prompt 
sequence) parameter was specified in 
the COM command line. If no prompt 
sequence is specified, the 8540 may be 
transmitting information before the host 
computer is ready to accept input. 



Unformatted ASCII Download 



Unformatted Binary Download 



Unformatted ASCII Upload 



Unformatted Binary Upload 



(a) 
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Section 5 
EMULATION 



INTRODUCTION 

The 8085A emulator demonstration run in the Learning 
Guide of this manual showed you howtoload, execute, and 
monitor a program in emulation mode 0. This section. 
Emulation, discusses the following topics: 

• the three emulation modes 

• the basic emulation tasks, many of which were 
presented in the Learning Guide 

• additional considerations for emulation modes 1 and 2 

• use of symbolic debug 

• the Memory Allocation Controller (MAC) option 

• the Trigger Trace Analyzer (TTA) option 

This section describes the common uses of many OS/40 
commands. For information on the syntax and limitations 
of these commands, and for examples of their use, refer to 
the Command Dictionary of this manual. For a more 
detailed description of the TTA, refer to the Trigger Trace 
Analyzer Users Manual. 



THE EMULATOR 

The emulator (or emulator processor) is one or more 
circuit boards that reside in the 8540. The emulator 



contains an emulating microprocessor on which your 
program executes, plus control circuitry that allows you to 
start, stop, and monitor program execution using OS/40 
commands. For most emulators, the emulating micro- 
processor is of the same type as the microprocessor being 
emulated. 

The term emulator registers refers to the registers of the 
emulating microprocessor. The emulator is said to be 
"halted" whenever the emulating microprocessor is not 
'executing your program. 

As your program executes, the emulator monitors the 
emulating microprocessor and intervenes when a break or 
service call (SVC) occurs. 



EMULATION MODES 

in order to execute a microprocessor-based program, you 
normally need the following pieces of hardware: 

• a microprocessor on which to execute the program 

• a clock to drive the microprocessor 

• memory for the program to reside in 

• I/O facilities: external circuitry to control or respond to 
the microprocessor. 



@ 
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A. Emulation 
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C. Emulation Mode 2 
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Fig. 5-1. Emulation Modes 0, 1, and 2. 

This figure illustrates the differences between the three emulation modes. Mode uses the 
emuidLui uluck, ptuytdtn rnetnory, and SVCs (which are pan of i he system resources), iviode i 
uses the prototype clock, either program or prototype memory, and either SVCs or prototype 
10. Mode 2 uses the prototype clock, prototype memory, and either SVCs or prototype I/O. 



So that you may execute your program even before your 
prototype hardware is available, the 8540 provides or 
simulates all of the necessary hardware. Once your 
prototype is built, you can begin transferring the necessary 
hardware functions from the 8540 to your prototype. You 



indicate which of these functions are handled by the 8540 
and which are handled by the prototype by specifying the 
emulation mode. Refer to Fig. 5-1 during the following 
discussion. 
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Basic Emulation Tasks 



The three emulation modes are: 

• Mode (system mode). Mode uses the emulator clock 
and program memory. Program I/O is handled through 
service calls (SVCs). Until your prototype is connected to 
the emulator, your program can executeonly in modeO. 

• Mode 1 (partial emulation mode). Mode 1 uses the 
prototype's clock, and is the only mode in which the 
program may access both program memory and 
prototype memory. An internal memory map determines 
whether a particular address refers to program memory 
or prototype memory. Program I/O is handled with 
prototype I/O facilities, SVCs, or both. 

• Mode 2 (full emulation mode). Mode 2 uses the 
prototype's clock, memory, and I/O facilities. Some 
emulators support the use of SVCs in mode 2. 

In all three emulation modes, the emulator takes the place 
of the microprocessor that will eventually reside in the 
working prototype. In modes 1 and 2, a prototype control 
probe must connect the prototype to the emulator. 

NOTE 

Some emulators do not support SVCs in emulation 
modes 1 or 2. Refer to the Emulator Specifics section 
of this manual to determine whether your emulator 
supports the use of SVCs in modes 1 and 2. 

Table 5-1 summarizes the three emulation modes. 

The "Basic Emulation Tasks" subsection describes 
features that are common to all three emulation modes. 
Special considerations for modes 1 and 2 are presented 
later in the section. 

SELECTING THE TARGET 
PROCESSOR 

Because your 8540 System ROM Board may contain 
software for more than one microprocessor, you must 
specify which microprocessor your program is written for 
before you attempt to execute a program. 



The SEL command selects the system software that is 
appropriate for your microprocessor. For example, the 
command SEL 8085 specifies that subsequent micro- 
processor-dependent commands refer to the 8085A 
emulator. Certain emulator-related OS/40 commands 
cannot be executed until an emulator has been selected. 
Those commands are listed in the discussion of the SEL 
command, in the Command Dictionary of this manual. 



BASIC EMULATION TASKS 

This subsection discusses the following aspects of 
emulation: 

• memory 

• executing the program 

• monitoring the program 

• modifying the program 

• timing 

• SVCs 

• interrupts 

Except where otherwise stated, this information applies to 
all three emulation modes. Special considerations for 
modes 1 and 2 are presented later in this section. 

To select emulation mode (system mode), enter the 
following command: 

> EM 

In mode 0, your program executes in program memory 
independently of the prototype hardware. Through SVCs in 
your program, you can use the I/O facilities of the 8540 to 
simulate the real-world interfaces of the prototype 
microprocessor. 

Memory 

In emulation mode 0, the 8540's program memory takes 
the place of the memory in your prototype. 



Table 5-1 
Emulation Modes 



Emulation Mode 


Memory 


I/O Facilities 


Clock 


Required Hardware 





Program 


SVCs 


Emulator 


Emulator 


1 


Program and/or 
Prototype, 
depending on 
memory map 


Prototype and 
(if supported) 
SVCs 


Prototype 


Emulator, 
Prototype 
Control Probe 


2 


Prototype 


Prototype and 
(if supported) 
SVCs 


Prototype 


Emulator, 
Prototype 
Control Probe 
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In order to simulate ROM modules, you can use the RO 
parameter of the MAP command to designate blocks of 
program memory as read-only. If your program tries to 
store data into a read-only area, OS/40 generates a break 
and the protected area remains unchanged. 

If your 8540 has only 32K bytes of program memory, your 
program can still access addresses in the range 
8000-FFFF. You can use the AL command to make blocks 
of existing program memory represent addresses in the 
8000-FFFF range. 

If you have a Z8001/Z8002 emulator or 68000 emulator, 
you should have the Memory Allocation Controller 
(MAC) option installed in your system in order to use 
addresses outside the range of existing program memory. 
The MAC option is discussed later in this section. 



Executing the Program 

The demonstration run in your Emulator Specifics 
suppiement contains instructions for assembling a source 
program on an 8560 or other host computer. Use your host 
computer to prepare binary object code from your source 
program, then download the object code to your 8540. Use 
the G command to begin program execution. You can use 
any of several methods to stop program execution: 

• Insert a HALT instruction (or the corresponding 
instruction, if any, for your microprocessor) into your 
program. 

• Insert an SVC such as Exit Program (function 1A) or 
Abort Program (function IF) into your program. 

• Set a breakpoint, using the OS/40 BK command. (If you 
have the TTA option installed, you may use the TTA 
events and breakpoints.) 

• Type CTRL-C while the program is executing. 

After the program has been stopped by one of these 
methods, use the G command to resume execution. 

If you need to execute a program segment repeatedly to 
detect an intermittent bug, use the -R or -L parameter of 
the G command. 



Monitoring the Program 

In case you r program does not execute as expected, OS/40 
provides several ways to locate the problem. The following 
paragraphs describe some methods of monitoring the 
program. 



The TRA Command 



YrM 
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running display of the principal registers as the program 
executes. Each time your program executes an instruction, 
OS/40 displays a trace line that lists the instruction and 



Once you have narrowed the problem down to one area of 
the program, you can specify that only that area be traced. 
By using the -S option of the TRA command, you can step 
through critical areas one instruction at a time: you type G 
when you are ready to execute the next instruction. 

You can obtain an abbreviated trace that shows the logical 
flow of your program. The TRA JMP option lets you trace 
only jump instructions (unconditional jumps, subroutine 
calls, and conditional jumps when the conditions are 
satisfied). 

NOTE 

When any TRAce selections are in effect, your 
program executes at less than normal speed even in 
those parts of the program that are not traced. 



The BK Command 

You can use the BK (BreaK) command to cause your 
program to break when a particular address is accessed. By 
setting a breakpoint at the end of a program segment, you 
can suspend execution to verify that the segment has 
executed correctly. If you suspect that your program is 
straying outside a particular block of data or instructions, 
you can find out by setting breakpoints at the boundaries of 
the block. To clear a breakpoint, use the CLR parameter of 
the BK command. 



TTA Option 

If you have a Trigger Trace Analyzer, you have many more 
tracing and breakpoint options available to you. 

The TTA automatically maintains a trace of the processor's 
address bus, data bus, and control signals. The TTA can 
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any time by using the DISP command. 

You can also define breakpoints and other actions based on 
criteria that would be too complicated to define if you used 
only the BK command. For more information on the TTA, 
refer to the "Trigger Trace Analyzer" discussion later in this 
section. 
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Diagnostic Messages 

You can insert high-level language statements or assembly 
language SVCs (such as Write ASCII and Wait) into your 
source code, so that your program issues its own diagnostic 
messages as it executes. 



Other Commands 

We've looked at several methods of monitoring the 
program. Here are some addition commands you can use: 

• The DS (Display Status) command displays thefull set of 
registers. (For some emulators, this information is part 
of the standard trace display. For others, you can obtain 
this information by specifying the -L option with the TRA 
command.) 

• The D (Dump) command displays the contents of a 
specified section of memory in both hexadecimal and 
ASCII formats. 

• The Dl (Disassemble) command translates object code in 
memory back into assembly language mnemonics. Dl is 
used to display blocks of instructions; D is used to 
display blocks of data. 



Modifying the Program 

Once you have located a problem in your program, you have 
several ways to fix it. One way is to correct the source code 
and compile, assemble, link, and down load the program 
over again. Often, however, you can first verify the effect of 
the change by modifying the object code or registers 
directly. 

To change the object code or other information in memory, 
you can use one of the following commands: 

• The P (Patch) command stores a string of bytes or words 
at a specified location in memory. 

• The EX (EXam) command lets you modify an area of 
memory byte by byte or word by word. Use EX instead of 
P if you want to change only selected bytes, or if you 
want to see the previous contents of each byte before 
you change it. 

• The F (Fill) command fills an area of memory with a 
specified value or string of values. One common use of F 
is to zero out a block of memory. 

To change register contents, use the S (Set) or RESET 
commands. S changes only the registers you select; RESET 
simulates a reset signal to your microprocessor. 

You can obtain a working program by modifying your object 
code, then using the SAV or COM command to upload the 
modified code into a load file. Be sure to update your source 



code to match your object code. One way to keep track of 
the modifications to your object code is to use the LOG 
command to create a log of your debugging session. 



Timing 



In emulation mode 0, the clock signal to the emulating 
microprocessor is provided by the emulator. For most 
emulators, the clock frequency in modeO is the same as the 
maximum frequency allowed for the prototype clock in 
modes 1 and 2. Refer to your Emulator Specifics 
supplement for this clock information. 



Timing a Program Segment 

In order to optimize the execution time of your program, it is 
useful to be able to measure the execution times of 
program segments. You can obtain an accurate approxi- 
mation of a program segment's execution time even before 
the prototype is available. Simply timethe segment in mode 
and adjust for the difference between the emulator clock 
rate and the prototype clock rate. 

To time a segment, use the 8540's program clock or the 
TTA's genera! purpose counters. 

• The program clock increments every 100 milliseconds 
during program execution. The CLOCK command turns 
this clock on and off and displays the clock value. The 
clock value can also be accessed through the Read 
Program Clock SVC (function 11). 

• The general purpose counters, which are explained later 
in this section, provide more precision and versatility 
than the program clock. 

NOTE 

When the program clock is running, your program 
executes at slightly less than normal speeds. 



Factors That Affect Timing 

The following activities cause the emulating micro- 
processor to wait or halt, and so may disrupt the timing of a 
program segment: 

• Executing an SVC halts the emulating microprocessor 
until the SVC is completed. 

• Tracing with the TRA command causes the emulator to 
execute your program one instruction at a time. After 
each instruction, the emulating microprocessor pauses 
while OS/40 determines whether a trace line is to be 
displayed. 

• A keystroke on the terminal momemtarily pauses the 
emulator. 
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If you must time a program segment that contains such 
interruptions, use a general purpose counter of the TTA 
and specify a very small time unit, such as clock cycles. The 
general purpose counter will not count during the SVC or 
trace pause. 



SVCs 

Service calls (SVCs) allow your program to read and write 
text and binary data, and perform many other OS/40 
functions. Depending on your application, you may be able 
to use SVCs to help simulate the prototype circuitry your 
program will have to deal with. 

The Service Calls section of this manual describes each 
type of SVC function in detail, and also describes the four 
parts of an SVC request. These parts are: 

• an I/O instruction that invokes the SVC; 

• a pointer in the Service Request Block (SRB) vector, 
which provides a logical link from each SVC invocation 
to the appropriate SRB; 

• a Service Request Block (SRB) that specifies the 
function to be performed; and 

• an I/O buffer, if needed. 

The Service Request Block (SRB) vector is a table of 
addresses that point to the beginning of each SRB . For most 
emulators, the SRB vector is assumed to begin at byte 40 of 
program memory. If your program needs that memory area 
for other uses, you can choose a different area for the SRB 
vector. Use the SVC command to notify OS/40 of the new 
location. 

Similarly, the I/O Instruction that initiates the SVC usually 
must specify a port in the range F0-F7, but you can use the 
SVC command to allocate a different range of ports for this 
purpose. 



NOTE 

When you set a breakpoint at an instruction that 
involves an SVC, the break occurs after the SVC is 
executed. 

For some emulators, execution of the SVC may 
prevent OS/40 from breaking at the desired 
instruction. 



Interrupts 



In mode 0, you have no way of triggering an interrupt line 
during program execution. However, here is one way to 
simulate a randomly timed interrupt: 

1 . Start the program. 

2. Type CTRL-C to break the program at a random 
location. 

3. You will want your program to return to this location 
when it has finished processing the interrupt. Obtain 
the value of the program counter from the break 
display line; use a command such as P to store this 
value where your program can retrieve it (on the stack, 
for example). 

4. Use the G command to jump to a section of the 
program that simulates the interrupt. Afterward, your 
program retrieves the old program counter value and 
continues from where you typed CTRL-C. 

Notice that the emulator is always halted when such an 
"interrupt" occurs. 



CONSIDERATIONS FOR 
MODES 1 AND 2 

In emulation modes 1 and 2, your program executes in the 
prototype under 8540 control. The prototype must be 
connected to the emulator via the prototype control probe. 



^ CAUTION 



1 



Phasing Out SVCs 

Another use of the SVC command is to turn SVCs ON 3nd 
OFF. Since your prototype should handle its own I/O, you 
will eventually want to eliminate the SVCs from your 
program. The command SVC OFF suppresses execution of 
SVCs: SVC invocations are simply executed as I/O 
instructions. 

The SVC OFF feature is most useful for programs that use 
SVCs for purely diagnostic purposes. If the SVCs perform 
some vital function for the program, such as obtaining 
required input, you must develop an alternate form of the 
program in which the SVC functions are taken over by the 
prototype 



Before you begin emu/at ion in modes 1 and 2. refer to 
your Emulator Processor Installation Manual for the 
following information: 

a. electrical specifications for the probe- 
prototype interface: power, impedance, 
drive, etc; and 

b. instructions on how to connect the proto- 
type control probe to the emulator and to the 
prototype. 

Also refer to the Emulator Specifics section of this 
manual for possible timing discrepancies between 
the prototype control probe and the microprocessor 
that it replaces. 
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Once your prototype is connected to the emulator, and the 
prototype and 8540 are turned on, verify that your program 
still executes correctly in mode under this arrangement. If 
it does not, the prototype may be causing the problem, or 
the prototype control probe may be damaged. If you suspect 
damage, refer to your Emulator Processor Installation 
Manual for verification procedures. 

Next, use mode 1 to verifythat the memory modules in your 
prototype are working correctly. When the prototype's 
memory and I/O are working correctly, you can proceed to 
mode 2 to solve the more subtle problems. 



Memory 



OS/40 maintains an internal table, called the memory 
map, that indicates which address blocks refer to program 
memory and which blocks refer to prototype memory. You 
use the MAP command to control this memory map. For 
most emulators, memory is mapped in 128-byte blocks. 

OS/40 consults the program/prototype memory assign- 
ment of the memory map only in emulation mode 1. In 
mode 0, only program memory is used; in mode 2, only 
prototype memory is used. However, changing the 
emulation mode does not change the memory map or 
memory contents. 

The program/prototype memory assignment (defined by 
the emulation mode and memory map) is observed by 
OS/40 when it executes your program, and also when it 
executes any command that accesses memory (for 
example, LO, P, or D). 

When you change the memory map, be sure to move the 
corresponding blocks of object code between program and 
prototype memory. You can use the LO or COM command 
to reload your entire program, or you can use MOV to copy 
selected areas of memory. 






) CAUTION < 

In emulation mode 1, memory-write operations 
performed in program memory are also performed in 
the corresponding bytes of user prototype memory, 
for most emulators. 



Memory Protection 

Unlike program memory, prototype memory cannot be 
write-protected by the MAP command, for most emulators. 
The procedure "Breaking When the Program Writes in a 
Designated Memory Area," in the Operating Procedures 
section of this manual, shows you how to use the TTA to 
detect a write to a read-only area of prototype memory. 



Executing the Program 

In modes 1 and 2, no break occurs when your program 
executes a HALT instruction (or the corresponding 
instruction, if any, for your microprocessor), even if you set 
a breakpoint at that instruction. 



SVCs 

Refer to the Emulator Specifics section of this manual to 
determine whether your emulator supports SVCs in modes 
1 or 2. 

In mode 1, the instruction sequence that invokes the SVC 
can reside in either program memory or prototype memory. 
The Service Request Block (SRB) vector. Service Request 
Block (SRB), and optional I/O buffer(s) must reside in 
program memory. 

In mode 2, all parts of the SVC must be located in prototype 
memory. 

In modes and 1 , the I/O instruction that invokes the SVC 
must be followed by one NOP instruction. In mode 2, the 
I/O instruction that invokes the SVC must be followed by 
two NOP instructions. 



Interrupts 

Your prototype may attempt to interrupt the emulating 
microprocessor when it is stopped during a break, SVC, or 
TRAce activity. Most emulators do not detect such 
interrupts. 



SYMBOLIC DEBUG 

NOTE 

Some emulators do not support symbolic debug. 
Refer to your Emulator Specifics supplement for tfiis 
information. 

Symbolic debug allows you to use the symbols from your 
assembly language program in place of hexadecimal 
numbers when you are debugging. You can use your 
symbols as parameters in all OS/40 commands that accept 
expressions as parameters. For example, let's assume you 
have a segment of assembly language code having label 
START at its starting address (1 OOH) and label FINISH at its 
ending address (220H). Then the following two forms of the 
TRA command are equivalent: 

> TRA ALL 100 220 

> TRA ALL START FINISH 
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The command line may also include the name of the 
assembler section in which the symbol is found. This is 
useful if the same symbol is used in more than one section 
and it is not defined as a global symbol. (Refer to your 
Assembler Users Manual for information about sections 
and global symbols.) For example, if START is in section 
TEST1 and FINISH is in section TEST2, the TR.A command 
could be entered: 

> TRA ALL TESTl: START TEST2: FINISH 

In the output display, symbolic debug replaces each 
hexadecimal address with either a symbol (taken from the 
label field of your program), or its position relative to the 



start of the current section (as shown in the location 
counter field of your assembler listing.) Figure 5-2 contains 
an example of a trace display without symbolic debug. 
Figure 5-3 contains an example of a trace display with 
symbolic debug. 

The "section + offset" feature is not implemented for 
absolute sections. (Refer to your Assembler Core Users 
Manual for information about absolute sections.) 

For most 8-bit emulators, symbols are truncated to eight 
characters when displayed. 
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Fig. 5-2. Trace display without symbolic debug. 

This is an example of a trace display without symbolic debug. 
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Fig. 5-3. Trace display with symbolic debug. 

With symbolic debug, each hexadecimal address is replaced with either a label or its offset 
from the beginning of a section. In this example, Sectionl begins at 1000H and section2 
begins at 1050H. 



5-8 



REV JAN 1983 



Emulation— 8540 System Users 



The Memory Allocation Controller 



Using Symbolic Debug 

To make your program symbols available for use in 
symbolic debug, you must perform the following steps: 

1. If you are using a Tektronix assembler: 

a. AM assembly source files that have symbols to be 
referenced by symbolic debug must include the 
assembler directive LIST DBG. This directive 
causes the assembler to output the symbols to the 
object module, which is used by the linker. 

b. Include the DEBUG or -d command option when 
invoking the linker. For the A Series linker, enter: 

> LINK 

* LOAD loadfile 

* DEBUG 



• The ADDS command enables you to add symbols to the 
table during a debugging session. You may not add 
section names with this command. If you have not 
already loaded your symbols from the load module using 
SYMLO or COM, any symbols you add with ADDS are 
placed in a default section called NO. SECTION. If you 
later use SYMLO, the values in NO. SECTION are lost. 

• The REMS command deletes symbols from the symbol 
table. 

• The SYMB command gives the symbolic equivalent of a 
hexadecimal address. For example, using values from 
Fig. 5-3: 

> SYMB 1055H <CR> 



1055H=LABEL003 



For the B Series linker, enter: 

$ link -o loadfile -d . . . 

This directive causes the symbols and their values 
to be stored in the load module. 

c. Enter the SYMLO command, which downloads 
the symbols and their values from the bad module 
to the symbol table in 8540 system memory. 
SYMLO accepts files produced by B Series as- 
semblers, the B Series linker, or the A Series 
linker, but does not accept unlinked files produced 
by A Series assemblers. 

If you are not using a Tektronix assembler, your 
program symbols and their values must be placed In 
Extended Tekhex symbol blocks and downloaded with 
the rest of your load modules, using the COM 
command. 



> SYMB 1057H 



<CR> 



1057H=SECTI0N2+007 

• The CALC command finds the value associated with a 
symbol. For example: 

> CALC symbol 

symbol =30FFH 

Refer to the Command Dictionary for details of the 
parameters and syntax of symbolic debug commands. 



THE MEMORY ALLOCATION 
CONTROLLER 



Enabling Symbolic Debug 

The SYMD command enables and disables symbolic debug 
In the displays of commands such as TRA and Dl. Refer to 
the Command Dictionary for syntax and parameters of the 
SYMD command. 



Other Symbolic Debug Commands 

The following paragraphs describe the other commands 
used with symbolic debug: 

• The SYMLO command extracts your symbols from the 
load module and loads them into the symbol table. (The 
symbol table holds approximately 10CX) symbols.) You 
can specify that the symbols be loaded from selected 
sections only. 



The Memory Allocation Controller (MAC) Is a hardware 
option that permits the expanded addressing capabilities of 
emulators such as the Z8001 /Z8002 and 68000 to operate 
within the confines of 8540 program memory. (The 8086 
emulator performs this function internally and does not 
need the MAC board to execute the memory allocation 
commands.) 

The MAC option consists of: 

• the MAC circuit board that inserts into the 8540 
mainframe 

• the top plane bus that connects the MAC board to the 
emulator and the Trigger Trace Analyzer (TTA) option 

Figure 5-4 Illustrates the position of the top plane bus. 
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Fig. 5-4. The top plane bus. 

The top plane bus carries signals used by Large Address Space emulators, the Memory 
Allocation Controller, and the Trigger Trace Analyzer circuit boards. 
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68000 Memory Spaces 



Z8001/Z8002 Memory Spaces 



Fig. 5-5. 68000 and Z8001/Z8002 Memory Spaces. 

This figure illustrates the memory spaces available with the 68000 and Z8001 /Z8002 
microprocessors. You can specify up to four memory spaces for the 68000, and up to six 
memory spaces for the Z8001/Z8002. 
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Both the 68000 and Z8001 /Z8002 emulators allow you to 
designate memory areas for system (supervisor) use only or 
for user (normal) use only. You can further specify that 
these system or user areas be reserved for data, program 
code, or (for the Z8001 /Z8002), the stack. These divisions 
are called memory spaces. Figure 5-5 illustrates how the 
memory spaces are divided and named for the 68000 and 
Z8001/Z8002 emulators. Figure 5-5 also includes the 
abbreviations used in the memory allocation commands. 
Refer to your 68000 or Z8001/Z8002 Emulator Specifics 
supplement for more information on memory spaces. 

The memory spaces are differentiated by control signals 
from the microprocessor. For this reason, two or more 
blocks of memory assigned to different memory spaces can 
have the same addresses. 



Memory Allocation 



Program memory is allocated in 4K-byte blocks. Each 32K 
of program memory in your system consists of eight blocks. 
The MAC board maintains an internal allocation map to 
translate logical addresses from the emulator into 
physical addresses in program memory. 



commands without a memory space qualifier, the 
command defaults to the MEMSP value. 

The AL (Allocate) command assigns logical addresses to 
4K-byte blocks of program memory. The command line can 
specify one or more memory space qualifiers, or none. The 
following examples use a 68000 emulator in a system 
configured with 64K of program memory. 

> AL 38000 



1 BLOCK(S) ALLOCATED 



038000 



038FFF 



This command allocates one 4K-byte block of program 
memory to logical addresses beginning at 38000H. OS/40 
returns the number of blocks allocated, and the block 
boundaries. 

Entering AL without parameters displays a list of the 
allocated memory, including the memory space assign- 
ments: SP and SD are supervisor program and supervisor 
data, respectively. UP and UD are user program and user 
data, respectively. In these examples, the default allocation 
includes all memory spaces. 

> AL 

038000 038FFF SP SD UP UD 

1 BLOCK(S) ALLOCATED 15 BLOCK(S) FREE 



MAC Commands 

The following paragraphs describe the commands 
associated with memory allocation. AL and DEAL affect 
program memory; MEM and NOMEM affect prototype 
memory. 

You can set a default memory space value with the MEMSP 
command. If you enter one of the memory allocation 



The display includes the number of blocks allocated and the 
number of blocks still available. 

Allocations are cumulative. The command sequence in 
Display 5-1 allocates one 4K-byte block to supervisor 
program and supervisor data, and a different 4K-byte block 
to user program and user data. The display from the AL 
command includes the allocation from the previous 
example. 



> AL SP:SD:4000 4FFF 






1 BLOCK(S) ALLOCATED 


004000 004FFF 




> AL UD: UP: 4000 4FFF 






1 BLOCK(S) ALLOCATED 


004000 004FFF 




> AL 






004000 004FFF 


SP SD . . 




004000 004FFF 


. . UP UD 




038000 038FFF 


SP SD UP UD }-* 


- previously allocated 


3 BLOCK(S) ALLOCATED 


13 BL0CK{S) FREE 





Display 5-1 
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The command sequence shown in Display 5-2 allocates 
one block of memory to each memory space, though each 
memory space has the same addresses: 1000 to 1FFF. 

When you allocate more than one block of memory in one 
command, AL displays the allocation block by block. In the 

pypnnnip in nicnipv/ R-'^ acciimo that v/mi hax/o nr> nthor 

memory allocated. 



If you attempt to allocate more memory than you have 
available, the following error message is displayed: 

No more Program memory available 

You must use the DEAL command to deallocate one or 
more blocks before you try to allocate again. 



/oc Q nrav/irM ic 



allocation, and makes one or more 4K blocks available to be 



> AL SP:1000 








1 BLOCK(S) ALLOCATED 


001000 


OOIFFF 




> AL SD: 1000 








1 BLOCK(S) ALLOCATED 


001000 


OOIFFF 




> AL UP: 1000 


001000 


OOIFFF 




1 BLOCK(S) ALLOCATED 


> AL UD:1000 








1 BL0CK{S) ALLOCATED 


001000 


OOIFFF 




> AL 








001000 OOIFFF 


SP 






001000 OOIFFF 


. . SD . . 






001000 OOIFFF 


. . UP 






001000 OOIFFF 




UD 




004000 004FFF 


SP SD 


UD 'v^, 

UD .' 




004000 004FFF 


. . . . UP 


previously allocated 


038000 038FFF 


SP SD UP 




7 BLOCK(S) ALLOCATED 


9 BLOCK(S) 


FREE 
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> AL SP 


UP:0 2FFF 












3 BLOCK(S) ALLOCATED 




000000 


002FFF 


> AL SD 


UD:0 2FFF 




000000 


002FFF 


3 BLOCK(S) ALLOCATED 


> AL 














000000 


OOOFFF 


SP 




UP 






000000 


OOOFFF 




SD 




UD 




001000 


OOIFFF 


SP 




UP 






001000 


OOIFFF 




SD 




UD 




002000 


002FFF 


SP 




UP 






002000 


002FFF 




SD 




UD 




6 BLOCK(S) ALLOCATED 


10 


BLOCK (S 


FREE 



Display 5-3 
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reallocated. You can remove all previous allocations with 
the -A parameter, or you can specify the address range to 
be deallocated. 

NOTE 
DEAL does not use the default memory space values 
from the MEMSP command: if no memory spaces are 
specified with an address, DEAL deallocates all 
memory spaces. 

The default condition for AL and DEAL is that no 
memory is allocated. 

The NOMEM (No Memory) command informs the 
emulator that no memory exists in the prototype for a given 
block of addresses. Like the AL command, the NOMEM 
command accepts memory space qualifiers, and designates 
memory in 4K-byte blocks. Entering NOMEM without 
parameters displays the current state of non-existent 
memory. Both NOMEM and MEM display the status in 
terms of memory spaces. For example: 

> NOMEM 201000 

> NOMEM 



TheTTA is an optional hardwareproductthatenhancesthe 
emulation capabilities of your 8540. The TTA consists of 
the following modules: 

• two TTA circuit boards that insert into the 8540 
mainframe 

• two TTA interconnect cables that physically connect the 
two boards 

• a Data Acquisition Interface unit that mounts into the 
8540 rear panel 

• a Data Acquisition Probe that connects the Data 
Acquisition Interface to user-selected circuits in the 
prototype 

• the optional top plane bus that connects the TTA to the 
MAC board and certain emulators. (Refer back to Fig. 
5-4, which illustrates the top plane bus.) 

The Trigger Trace Analyzer Installation G uide explains how 
to install the TTA circuit boards and Data Acquisition 
Interface unit. The Trigger Trace Analyzer Users Manual 
explains how to connect the test clips of the Data 
Acquisition Probe to your prototype. 



INVALID USER MEMORY ADDRESSES 



UD 


201000 


201FFF 


UP 


201000 


201FFF 


SD 


201000 


201FFF 


SP 


201000 


201FFF 



If your program attempts to access non-existent memory, a 
break is generated and the trace line includes the message: 
"NO-PMEM" or "NO-UMEM" . 

The MEM (Memory) command informs the emulator that 
the prototype does contain memory at a given block of 
addresses. The MEM command is used to reverse a 
previous NOMEM command. You can use address 
parameters and memory space qualifiers with the MEM 
command. Entering MEM without parameters displays the 
current state of existent memory. 

NOTE 

The default condition for MEM and NOMEM is that all 
prototype memory exists. 

THE TRIGGER TRACE 
ANALYZER 

This subsection summarizes the use of the Trigger Trace 
Analyzer (TTA). For more detailed information and some 
examples of how the TTA is used, refer to the Trigger Trace 
Analyzer Users Manual. 



Overview 

The following paragraphs are an overview of the TTA 
option. The TTA features are discussed in detail later in this 
subsection. 

The TTA is a real-time debugging tool. Your program 
executes at normal speed while the TTA monitors the 
buses and certain control signals. TheTTA allows you great 
control in specifying which combinations of signals 
constitute an event, and what actions follow when an 
event occurs. The TTA can store up to 255 bus transactions 
in its Acquisition Memory, allowing you to capture a 
window of data during program execution. The TTA is 
capable of precise timing with a variety of source signals. 

The TTA includes the following features: 

• the ability to define four events based on combinations 
of input data from the buses and signals monitored; 

• four triggers that can break program execution, start or 
stop counters, or signal other instruments; 

• four general purpose counters; and 

• an Acquisition Memory that can store up to 255 bus 
transactions. 

We'll discuss each of these features in turn. 
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In this subsection, the term "input data" refers collectively 
to the following 64 bits of information monitored by the 
TTA: 

• the address bus (up to z.4 bits) 

• the data bus (8 or 16 bits) 

• the 8 test clips on the Data Acquisition Probe (up to 8 
bits) 

• the emulator-dependent bus sional interface iw^ to 1 1 

Kite frr»rn t^o orrii ilatr*r\ 

• the external event qualifier, via a BNC input on the Data 
Acquisition Interface (1 bit) 

• counter output signals (4 bits) 



Events and Triggers 



Many actions performed by the TTA are based on events 
and triggers. An event is the simultaneous occurrence of 
one or more specified conditions in the input data. The EVE 
command and several related commands are used to 
define up to four events. 

Each trigger has an associated event comparator and 
general purpose counter, which share the trigger channel 
number. A trigger is enabled by the output of its event 



comparator ANDed with the output of its general purpose 
counter. Figure 5-6 illustrates the relationships between 
an event, the counter, and the trigger. Each trigger can 
cause a breakpoint, increment a counter, or signal an 
external device (such as a logic analyzer) via a BNC output 
on the Data Acquisition Interface panel. 



Defining An Event 

You can select any of several event control commands to 
specify which input data constitutes an event. These event 
control commands correspond to the parameters of the 
EVE command. Once you are experienced with the TTA, 
you can use the EVE command to specify all the input data 
on one command line. For the full syntax of TTA commands, 
refer to the Command Dictionary in the Trigger Trace 
Analyzer Users Manual. 



Event Control Commands 

Cfar»K r\4 tKo 4r\\\r\\.At'ir\r% /^(r\mm^trtr\c r^art iiC£n Qr»\/ r\r oil r\i tho 

four trigger channels. All of the commands can use the -S 
and -C breakpoint flags. (Breakpoints are discussed later in 
this subsection.) 



input 
data 





EVENT 
COMPARATOR 










































I V TRIGGER 






H- 








^ smwAi 




GENERAL 
PURPOSE 
COUNTER 













Fig. 5-6. Generating a trigger signal. 

The output of the event comparator is ANDed with the output of the general purpose counter 
to produce the trigger signal. 
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The AD command is used to define a specific address or 
range of addresses as an event. 

> AD 1 105E 

> AD 2 500 530 

These commands specify that event 1 occurs whenever the 
program accesses address 105E, and that event 2 occurs 
whenever the program accesses an. address within the 
range 500 to 530, inclusive. 

The AD command can include a -N command modiflerthat 
defines the event as anything other than the value(s) 
specified. 

> AD -N 4 1000 lOFF 

This command defines event 4 as any address outside the 
range 1000 to 10FF. 

The BUS command allows you to select which bus signals 
are recognized as an event. The signals are emulator- 
specfic. All of the signals selected are ANDed together — 
watch out for impossible combinations such as F I (fetch 
AND I/O operation simultaneously). 

> BUS 3 NF 

This command defines event 3 as any non-fetch bus 
transaction. 

The CTR command defines an event as a pattern of the 
output of the four counters. The pattern can include 1 's, O's 
or X's (don't-cares). For example, the command 

> CTR 1 10X0 

causes event 1 to occur when counter 1 is high, and 
counters 2 and 4 are low. 

The DATA command defines an event as the occurrence 
on the data bus of a value or one of a range of values. Like 
the AD command, it can include a -N command modifier 
that defines the event as anything other than the value(s) 
specified. 

> DATA 3 0F3 

> DATA -N 2 10 3FF 

In the first command, event 3 occurs whenever the data 
bus contains the value F3. In the second command, event 2 
occurs whenever the data bus contains a value outside the 
range 10-3FF. 

The PRO command refers to the probe inputs via the Data 
Acquisition ProbeandtheDataAcquisition Interface Panel. 
The argument can be a two-digit hexadecimal number, or 
eight individual bits. You may include "don't-care" digits or 
bits (X) in hexadecimal or binary values, respectively. 
Entering PRO CLR makes all bits "don't-cares." The default 
radix for the PRO command is binary. 

> PRO 3 5XH 

> PRO 1 OXIXXOXIO 



NOTE 

Any number that does not begin with a digit in the 
range 0-9 must include a leading 0; otherwise 
OS/40 will attempt to evaluate the expression as a 
symbol and an error will be generated. 

The QUA command detects an input from the Event 
Qualifier BNC on the Data Acquisition Interface Panel. This 
input is user-controlled. The parameterforthis command is 
a or 1, or any expresson that evaluates to a or 1. 



The EVE Command 

The EVE command lets you specify all event control 
conditions on one command line. Each EVE command 
parameter corresponds to one of the event control 
commands we've discussed. The EVE command may 
include the following parameters: 

• A = Address — Corresponds to the AD command 

• AN = Address Not — Corresponds to the AD -N command 

• B = Bus — Corresponds to the BUS command 

• C = Counter Output — Corresponds to the CTR command 

• D = Data — Corresponds to the DATA command 

• DN = Data Not— Corresponds to the DATA -N command 

• P = Probe — Corresponds to the PRO command 

• Q = Qualifier — Corresponds to the QUA command 

The parameters of an event are cumulative. When a 
parameter is set, either with the EVE command or one of 
the event control commands, it remains in effect until 
cleared. The command 

> EVE 1 B=M WT 

changes only the B (Bus) parameter. All other parameters 
remain unchanged. The command 

> EVE 1 CLR B=M WT 

clears all previously specified conditions for event 1 and 
defines event 1 as any memory-write bus signal. 



Displaying Trigger Status 

The TS (Trigger Status) command displays the current 
programming of the triggers and their associated events 
and counters. The -E parameter causes only the event 
portion of the trigger(s) to be displayed. The -C parameter 
causes only the counter portion of the trigger(s) to be 
displayed. You can select the triggers to be displayed. TS 
entered with no parameters displays the status of all the 
triggers. Refer to your Trigger Trace Analyzer Users 
Manual for TS command examples. 



@ 
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Clearing All Trigger Conditions 

The TCLR {Trigger CLeaR) Command returns to the 
default condition the EVE, COU, and BRE commands 
associated with a given trigger channel. For example, the 
command TCLR 1 is equivalent to entering 

> EVE 1 CLR; COU 1 CLR; BRE 1 CLR 

The command line may specify more than one trigger 
channel to be cleared, or that ALL be cleared. 

The -X option resets the entire TTA. The command TCLR 
-X is equivalent to entering 

> EVE ALL CLR; COU ALL CLR; BRE ALL CLR; 

> CONS CLR; ACQ ALL 

The contents of the Acquisition Memory are not altered by 
this command. 



Consecutive Events 

In addition to triggering on individual events, it is possible 
to trigger on the consecutive occurrence of different 
events. By using the CONS command, events can be linked 
together so that the occurrence of an event arms the 
comparator of the following event. If the following event(s) 
do not occur on the specified bus cycle, then all events are 
reset and detection resumes with the first event in the 
sequence. The trigger is generated on the occurrence of the 
last event in the sequence. 

The CONS command requires you to select one bus mode 
in which all the events are considered. The bus modes are: 

• CYC — all bus cycles are allowed; 

• FET — only fetch cycles are considered; 

• EMU — only emulator-dependent bus cycles are con- 
sidered. 

NOTE 

FET and EMU mode are not implemented on all 
emulators. Refer to your Emulator Specifics supple- 
ment to determine whether these functions are 
available on your emulator. 

As an example, the following command sequence detects a 

lo\A/-tr»-hinh trancition in tho nr/->t/-it>/i->o f<-ill/->»«<irMi nr\ 

._ ...J,.. ..»..»...„.. ... ».,^ f,. vri.v,»,^,v-, •v./i.x^..ii ■jj uii 

instruction fetch: 

> EVE 1 CLR B=F P=OXXXXXOXX 

> EVE 2 CLR P=0XXXXX1XX -S 

> CONS CYC 12 



The first command defines EVE 1 as a fetch AND a logic low 
on probe input 2. EVE 2 is defined as a logic high on probe 
input 2. The CONS command says that EVE 2 will trigger a 



break (the -S parameter) only if EVE 2 occurs on the cycle 
following EVE 1 . 

You can direct the TTA to trigger on any of the following 
event sequences: 

12 123 1234 

23 234 2341 

34 341 3412 

41 412 4123 

You may specify two sequences concurrently, such as 23 
and 41. The sequences are independent of each other; 
however both must use the same bus mode. 



Breakpoints 



You can set breakpoints with the BRE command or with the 
-S or -C options of the various event control commands. 
The -S option produces a standard break, which stops 
execution of your program. The -C option prints a trace line 
and your program continues execution. 

To remove breakpoints, you must use the CLR parameter of 
the BRE command, in conjunction with a trigger number. 
You can clear all the breakpoints by entering: 

> BRE ALL CLR 

To view the status of the breakpoints, enter the BRE 
command without parameters. 



The General Purpose Counters 

Each of the four triggers has a general purpose counter 
associated with it. The counters are controlled by the COU 
command. Each counter has a value which you display 
using the TS command, and an output which must be high 
in order for the associated trigger to be generated. 



The COU Command 

iit€ \^\j\j oi/iiijiiaiivj I lao iivo fjai ai i loiot o. iiioy ai 

• V = Value 

• S = Source 

• = Output 

• G = Gate 

• R = Restart 



Value (V) is used to initialize the counter to the designated 
value. V can be any expression that evaluates to the range 
to 65535 if incrementing, or 1 to 65535 if decrementing. 
The default radix for V is decimal. 
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Source (S) is what the counter counts. You may select any 
one of the following sources for each counter: 

• time intervals: 200 nsec, 2 fjsec, 20 /usee, 200 /jsec, 2 
msec 

• occurrences of: EV1, EV2, EV3, or EV4 

• occurrences of: TRIG1, TRIG2, TRIG3, or TRIG4 

• ACQ: any transaction stored in Acquisition Memory 

In addition, there are 3 auxiliary counter sources to which 
special restrictions apply: Only one of these auxiliary 
sources can be selected at one time, though more than one 
counter can use the selected auxiliary source. When you 
select a second auxiliary source, it replaces the one 
previously selected. The auxiliary counter sources are: 

• CYC: all bus cycles 

• EMUCLK: clock on the emulator 

• QUA: low-to-high transitions on the Event Qualifier 
BNC input 

The ACQ command uses these counter sources with its 
FOR parameter. 

Output (O) controls when the counter output will be high. 
A trigger is generated when an event occurs and the 
counter output is high. See Table 5-2. 

Table 5-2 
Counter Output Options 





COUNTS 


Counter Outputs 


OPTIONS 


While 
Counting 


At" 

Terminal 

Value 


After 
Counting 


0=Arm 


Up 


1 


1 


1 


0=Disarm 


Up 











0=Pulse 


Down 





1 





0=Delay 


Down 








1 


0-Timeout 


Down 


1 


1 






For ARM and DISARM, the terminal value is 65535. For 
PULSE, DELAY, and TIMEOUT, the terminal value is 0. 

ARM and DISARM increment the counter from the initial 
value which is set with the V parameter. PULSE, DELAY, 
and TIMEOUT decrement the counter from the initial value. 
After the counter reaches its terminal value (of 65535 or 
0000, depending on the output option), it stops counting 
until you reprogram it, either with the COU command or by 
entering G with an address. 



NOTE 

The G command entered with an address reinitializes 
all the counters, including the one associated with the 
Acquisition Memory. G entered without an address 
leaves all the counters in their current states. 

Gate (G) controls when a counter can count its 
programmed source. It is only available with counters 2, 3, 
or 4. The G options are: 

G=QFF Removes any previous gate restrictions 

G=CTR Counter N counts only when counter N-1 

remains high 

G=TRIGH Counter N counts only when trigger N-1 

remains high 

G=TRIGL Counter N counts only when trigger N-1 

remains low 

G=SEQH Counter N begins counting when trigger N-1 

first goes high 

G=SEQL Counter N begins counting when trigger N-1 

first goes low 

G=SELF Counter N counts only when trigger N 

remains high 

Restart (R) is allowed only if the gate parameter has been 
specified. The R options are ON and OFF. R=ON causes the 
counter to reinitialize to the value specified by the V 
parameter, and begin counting again each time the gate 
function becomes true. R=OFF turns this feature off. 

The COU command, like the EVE command, is cumulative. 
Use the CLR parameter to remove previous conditions. For 
example, the command sequence 

> ecu 3 CLR V=100 S=ACQ 0=DELAY 

counts 100 acquisitions of Acquisition Memory and then 
outputs a high to Trigger 3. 



Acquisition Memory 



TheTTA maintains a record of input data ina255-by-62-bit 
buffer called the Acquisition Memory. The ACQ command 
selects which bus transactions are to be stored. Acquisition 
Memory contains the 255 most recent samples of input 
data. (The Acquisition Memory stores slightly different 
input data from that monitored by the event comparators.) 
The Acquisition Memory is similar to the buffer memory of 
a logic analyzer. Figure 5-7 shows how information is 
stored in the TTA Acquisition Memory. 
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V 

samples 1 
lost 



10 



I 1 
ADDRESS BUS 
(Up to 24 BITS) 



t 1 

DATA BUS 

((8 or 16 bits) 



TEST CLIPS 
(8 bits) 



BUS OPERATION TYPE 
(Up To 14 BITS) 



SAMPLE 1 1 
(oldest sample) 



SAMPLE 264 

SAMPLE 265 
(newest sample) 



input 
data 



Fig. 5-7. Acquisition Memory. 

This figure shows the contents of the Acquisition Memory after 265 samples of input data 
have been taken. Only the most recent 255 samples are stored. The DISP command is used to 
display the contents of the Acquisition Memory. 



The ACQ command selects which bus transactions are to 
be stored in Acquisition Memory. The parameters are: 

• ACQ ALL — all bus transactions are stored 

• ACQ EV4 — only the transactions defined as Event 4 are 
stored 

The Acquisition Memory begins storing when program 
execution begins and stops storing when the emulator 
halts. You may want to halt storage in the buffer before the 
program has finished execution. There are two ways to do 
so: 

> ACQ ALL FOR {value) {source! 

> ACQ EV4 FOR {value j {source) AFTERTRIG4 

You select one of the sources available with the COU 
command, and a value that equals the number of 
transactions you want to capture. For example, 

> ACQ EV4 FOR 10 EVl 

stores the transactions defined as event 4 until the tenth 
occurrence of event 1 . 



> ACQ AIX FOR 120 CYC AFTERTRIG4 

"AFTERTRIG4" delays the start of countmg until the 
conditions of TRIG4 have been met. In this example, 
acquisition stops 120 cycles after TRIG4 occurs. 

Entering the ACQ command without parameters returns 
the parameters currently selected. If the FOR clause is 
Included, the number of counts remaining to be acquired is 
also given. 

> ACQ 

Acquire EV4 for 00020T MSEC 
Counts remaining: 00018T 



The DISP command displays the contents of the 
Acquisition Memory. Entering DISP ALL displays the entire 
buffer, beginning with the oldest buffer contents. You may 
also use DISP to display a specified number of most recent 
transactions. DISP without parameters displays the 
transactions that have occurred since the emulator was 
last halted. 
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TTA Summary 



The following OS/40 commands control your TTA: 

• ACQ — selects the type of operation to be stored in the 
Acquisition Memory 

• AD — selects the address portion of an event 

• BRE — defines a breakpoint in terms of TTA events 

• BUS — selects the emulator-specific bus transactions 
that define an event 

• CONS — causes a trigger after a sequence of events has 
occurred on consecutive bus cycles. 

• COU — selects the counting units and output modes for 
the general purpose counters 

• CTR — defines an event as a pattern of the four counter 
outputs 



• DATA — selects the data portion of an event 

• DISP — displays the contents of the Acquisition Memory 

• EVE — defines an event in terms of the input data 

• PRO — selects signals from the Data Acquisition Probe 

• QUA — selects and defines an input from the Event 
Qualifier 

• TCLR— clears the EVE, COU, and BRE conditions 
associated with a given channel 

• TS — displays the status of the TTA or of selected triggers 

For more detailed explanations of these commands, refer to 
the Trigger Trace Analyzer Users Manual. For descriptions 
of common procedures that use these commands, refer to 
the subsection "Using the TTA" in the Operating 
Procedures section of this manual. 



@ 
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INTRODUCTION 

Service calls (SVCs) allow your program to perform various 
system operations. This section is divided into the following 
subsections: 

• SVC Overview — Describes the general features of 
SVCs. 

• Limitations of File-Handling SVCs— Describes the 
conditions under which SVCs can access files on the 
host. 

• I/O Channels— Describes the I/O channels used by 
some SVCs. 

• SVC Applications — Illustrates some useful SVC ap- 
plications. A brief description accompanies each 
application. 

• SVC Demonstration— Includes an 8080A/8085A 
assembly language program that incorporates several 
SVCs. A similar program is provided in the Emulator 
Specifics supplement for each emulator supported by 
the 8540. 

• SVC Functions — Gives the function code and format for 
each SVC. The functions are listed alphabetically in the 
text; the Table of Contents contains a numerical index. 

OVERVIEW 

OS/40 supports a number of service calls (SVCs). Some 
SVCs handle the transfer of data between your program 



and OS/40 peripherals (such as the system terminal or line 
printer), or files on the 8560. SVCs also instruct OS/40 to 
perform system operations, such as aborting the program 
or reading the system clock. 



When Should You Use SVCs? 

SVCs are especially useful during the initial stages of 
software development. While developing software, you 
may use SVCs to transfer data between your program and 
the 8540 system peripherals or files on the 8560. The SVCs 
permit your program to accept and display data. 

Once you are certain that your program functions correctly, 
you may replace the SVCs with I/O instructions in your 
microprocessor's assembly language. This allows you to 
check out your program using prototype memory, clock, 
and I/O. 



What is an SVC? 

An SVC consists of four parts: (1 ) the program instructions 
that generate the call; (2) a pointer within the Service 
Request Block vector; (3) a Service Request Block (SRB); 
and (4) an I/O buffer (for some SVCs). 



(a) 
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Thg format of the SRB vector and the Service Reouest Block 
(SRB) is determined by the type of microprocessor you are 
emulating. In general, microprocessors that can address a 
maximurn of 64K bytes use Srnaii Addrebs Space (SAS) 
format, while microprocessors that can address more than 
64K require Large Address Space (LAS) format. Refer to the 
Emulator Specifics section to determine which format your 
microprocessor uses. Table 6-i summarizes the difference 
iri SRB formats. Figure 6-1 illustrates the SAS memory 
layout. Figure 6-2 iMustrates the LAS memor^' layout. 

All emulators support the use of SVCs In mode 0; some 
emulators support the use of SVCs in modes 1 and 2. In 
mode 1 , the program instructions may be located in either 
program or prototype memory; the other parts of the SVC 
must reside in program memory. In mode 2, the SVC is 
located entirely in prototype memory. Refertothe Emulator 
Specifics section to determine whether your emulator 
supports SVCs in modes 1 and 2. 



Table 6-1 
Summary of SAS and LAS Formats 





Bytes 


Used 




Small Address 


Large Address 


SRB Field 


Space Format 


Space Format 


Name 


(SAS) J 


(LAS) 


Function 


1 


1 


Channei 


2 


2 


Status 


3 


3 


Fourth Byte 


4 


4 


Byte Count 


5 


5-6 


Buffer Length 


6 


7-8 


Buffer Pomter 


7-8 


9-12 



SRB 
Vector 



default 



SRB 
(Service Request Block) 





.- ! 




function 


SVu 1 


/ 

optional extra f 
SRB b"tes ^ 


SVC2 


channel 


SVC3 


status 


SVC4 


fourth byte 


SVC5 


byte count 


SVC6 


buffer length 


SVC7 


buffer 
pointer 


SVCS 


^ 




hinh 1 ■'^••> 








poiniers 




location 






Fig. 6-1. SVC memory layout. Small Address Space (SAS) format. 

An instruction sequence within your program determines which of the eight SRB pointers is used. The SRB addressed by the 
selected pomter contains the parameters needed to perform the SVC. Depending on the function specified in the first field of 
the SRB, an I/O buffer may be needed: m that case, the buffer length and buffer pointer fields indicate the length and location of 
the buffer 
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SRB 
Vector 


SRB 
(Service Request Block) 


Buffer 


(3457-37)3936-19 


40-43 
44-47 
48-48 
4C-4F 
50-53 
54-57 
58-58 
5C-5F 


SVC1 




function 


> 
/ 


optional extra 1 
SRB bytes J 


SVC2 


channel 


SVC3 


status 


SVC4 


fourth byte 


SVC5 


byte 
count 


SVC6 


SVC7 


buffer 
length 


SVC8 


^ 


buffer 
pointer 


defc 


lUlt 


high 
poi 


low 

Ttpr<; 




ocation 


1 to 100H 
bytes 



























Fig. 6-2. SVC memory layout. Large Address Space (LAS) format. 

An instruction sequence within your program determines which of the eight SRB pointers is used. The SRB addressed by the 
selected pointer contains the parameters needed to perform the SVC. Depending on the function specified in the first field of 
the SRB, an I/O buffer maybe needed; in that case, the buffer length and buffer pointer fields indicate the length and location of 
the buffer. 



Program Instructions 

The service call is triggered by a microprocessor- 
dependent instruction sequence. In modes and 1, this 
sequence usually consists of an I/O instruction followed by 
one no-operation instruction. (In mode 2, the sequence is 
an I/O instruction followed by two no-operation instruc- 
tions.) When the SVC instruction sequence is executed, the 
8540 hardware interrupts the system so that OS/40 may 
take the appropriate action. 

Execution of the SVC does not affect the emulator regis- 
ters. However, the instruction sequence that triggers the 
SVC may contain an instruction (such as IN) that modifies 
one or more registers. 

Eight instruction sequences are defined for each emulator. 
These instruction sequences are labeled SVC1 through 
SVC8. Refer to the Emulator Specifics section for the 
specific instruction sequence used by your emulator. 

The I/O addresses used in the microprocessor I/O 
instruction are in the range FOto F7 for most emulators. F7 
corresponds to SVC1, F6 to SVC2, and so on. You can use 



the OS/40 SVC command to change the I/O address range 
to any group of eight consecutive I/O addresses with least 
significant digits in the range of to 7. 

Service Request Block (SRB) Vector 

The Service Request Block (SRB) vector is a table of eight 
addresses beginning at address 40. Each address points to 
a different SRB. Although there are only eight SRB 
pointers, your program may use more than eight SVCs by 
changing the addresses in the SRB vector to point to 
additional SRBs. 

When the SVC instruction sequence is executed, OS/40 
examines the SRB pointer to determine the location of the 
SRB to be used. For example, if the instruction sequence for 
SVC1 is executed by an emulator that uses SAS format, 
OS/40 examines memory locations 40 and 41 to 
determine the location of the SRB for that call. Memory 
address 40 contains the high byte of the SRB address, and 
memory address 41 contains the low byte. If the instruction 
sequence for SVC1 is executed by an emulator that uses 
LAS format, OS/40 examines memory locations 40 
through 43 to determine the location of the SRB for that 
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caii. The high-order byte is in location 42; the low-order byte 
is in location 43. 



your program, you may change the location of the SRB 
vector. The OS/40 SVC command allows you to place the 
SRB vector nearly anywhere in memory. If you do not use 
the default SRB vector location, you must reenter this SVC 
command each time you reselect the emulator 

Service Request Block (SRB) 

The Service Request Block (SRB) contains the information 
that OS/40 needs to perform the service call. The SRB also 
reserves areas for OS/40 to return control information and 
data after the call is completed. The SRB may be located 
anywhere in memory. Refer to Table 6-1 as you read the 
following paragraphs. 

The function field of the SRB identifies the function of the 
call. This byte controls how OS/40 interprets the rest of the 
SRB. SVC functions are described individually later in this 
section. SVC functions not listed in this section are unsup- 
ported and may yield unpredictable results. 

The channel field usually contains an OS/40 channel 
number. Channels are discussed in the "I/O Channels" 
subsection, following this overview. 

OS/40 uses the third byte to return status. This status field 
contains 00 if the operation was successfully completed. A 
non-zero value returned in this byte indicates an abnormal 
condition, which may or may not be an error: status values 
06, 07, 29, 76, 7F, and FF are often not considered errors. 
These status conditions are listed by status code in the 
Error Messages section of this manual. 

The status field can also be used to return non-status 
information. Such uses are discussed in the description of 
the appropriate SVC function. 

The fourth byte is used by some functions in SAS format. 
The specific use of this byte is covered in the individual 
function description. The fourth byte is reserved for system 
use in LAS format. 

The byte count field indicates the number of bytes 
transferred during an I/O operation. This field is also used 
by SVCs that do not perform data transfer Refer to the 
specific SVC function description for details. 

The remaining bytes in the SRB describe an I/O buffer. This 
buffer is explained under the next heading. 

Some SVCs use additional bytes to form an extended SRB. 
The use of these bytes is described with the particular 
function that uses them. 

In an SRB, any byte that is not specifically designated to 
return data may contain unspecified vaiues(garbage)when 
the SVC is completed. 



I/O Buffer 

The I/O buffer is used when an I/O transfer is performed. 
Information that iS read nOm a device or nost Hie iS piaccu 
in the buffer after the SVC is called. Information to be 
written to an external device or host file is placed in the 
buffer before the call is made. I/O buffers may also hold 
ASCII strings (such as fiiespecs) used by some SVCs. 

The buffer length may be 1 to 256 bytes. In SAS format, the 
value OOH is used to indicate a length of 256 bytes, because 
the buffer length field is only one byte long. In LAS format, 
the value 100H indicates a buffer length of 256 bytes. 

The buffer pointer field contains the address of the first 
byte of the buffer, with the high-order byte or word given 
first. 

The buffer length and buffer pointer fields are used by some 
functions that do not perform I/O operations. The use of 
these bytes is discussed in the function description. 

LIMITATIONS OF FILE 
HANDLING SVCs 

The 8540 supports file handling SVCs (such as Create 
File— function 90) when the 8540 is operating in TERM 
mode with an 8560. If you are not in TERM mode, SVCs 
such as Assign, Read, Write, Open, and Close can only 
access 8540 peripherals. 

The following fiiespecs denote 8540 peripherals: CONI, 
CONO, REMI, REMO, LPT, PPTR, PPTP. Other fiiespecs are 
assumed to denote host files. 

I/O CHANNELS 

A channel is an independent data path for I/O operations. 
A channel may only be assigned to one device or file at a 
time. A channel can be disassociated ("closed") from the 
device or file and then reassigned. OS/40 provides 10 
channels: channels through 7 may be assigned and 
closed by your programs. Channels 8 and 9 are assigned by 
the system to standard input and output, respectively, and 
may also be used in your programs. OS/40 closes and 
reopens channels 8 and 9 each time the G or X command is 
used. 

In TERM mode, channels assigned to CONI and CONO are 
mapped into standard input and standard output, 
respectively. 

NOTE 

No more than five channels at a time may be open to 
files. 

It is possible to assign so many channels that OS/40 
cannot continue to operate. In that case, error code 
50 will be issued; the only way to recover from this 
condition is to enter the command A -A. 
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To avoid this condition, be sure to close a channel 
when you are finished with the file to which the chan- 
nel is assigned. To close one or more selected chan- 
nels, use the OS/40 CL command or the Close 
Channel SVC. To close all channels, use the OA/40 A 
command or the Abort Program SVC. 

OS/40 may allow you to read from a write-only chan- 
nel, such as standard output, but the results of such a 
read are undefined. 

SVC APPLICATIONS 

This subsection describes some common tasks that use 
service calls. Each SVC application describes the steps 
required to accomplish the task. The following applications 
are included here: 

• Assign a device or file to a channel. 

• Read a line from the system terminal or a file. 

• Write a line to the system terminal or a file. 

• Time a program segment. 

• Read binary data from a file. 

• Write binary data to a file. 

• Read a single byte from the system terminal. 

• Write a single byte to the system terminal. 

Assign a Device or File to a 
Channel 

This SVC application is used to associate a device or file 
with a channel. The device or file may then be used for data 
entry or display. 

1 . Create a buffer in memory containing the name of the 
device or file that you want to assign. The name must 
be terminated with a RETURN character. 

2. Establish an SRB containing the following information: 

a. Function: 10 (Assign). 

b. Channel: a number between and 7, inclusive. 

c. Buffer Pointer: pointing to the location containing 
the first character of the device or file name. 

3. Establish a pointer in the SRB vector and execute the 
corresponding SVC. 

4. Examine the status byte to verify that the SVC operated 
properly. 

Read a Line from the System 
Terminal or a File 

This SVC application reads a line from the system terminal 
or a file, and stores the characters in memory. 

1. Assign CON! (system terminal input) or the desired 
filespec to an available channel. 

2. Create a buffer in memory. Make sure that the buffer is 



as long as any line you expect to read, including the 
RETURN character. 

3. Establish an SRB containing the following information: 

a. Function: 01 (Read ASCII and Wait). 

b. Channel: the channel to which CONI orthefilewas 
assigned. 

c. Buffer Length: the length of the buffer that you 
created. 

d. Buffer Pointer: pointing to the first byte of your 
buffer. 

4. Establish a pointer in the SRB vector and execute the 
corresponding SVC. 

5. Examine the status bytetoverifythatthe SVC operated 
properly. 

Write a Line to the System 
Terminal or a File 

This SVC application displays a line on the system terminal, 
or writes the line to a file. The line must be stored as a 
sequence of ASCII characters terminated by a RETURN 
character. 

1 . Assign CONO (system terminal output) or the desired 
file to an available channel. 

2. Create a buffer in memory that contains the line of 
characters to be written, terminated with a RETURN 
character. 

3. Establish an SRB containing the following information: 

a. Function: 02 (Write ASCII and Wait). 

b. Channel; the channel to which CONO or the file 
was assigned. 

c. Buffer Length: the number of characters to be 
transferred, including the RETURN character. 

d. Buffer Pointer: pointing to the first character of the 
line. 

4. Establish a pointer in the SRB vector, and execute the 
corresponding SVC. 

5. Examine the status bytetoverifythatthe SVC operated 
properly. 

Time a Program Segment 

This SVC application allows you to determine the execution 
time of a program segment. You must first enable the 
program clock with the OS/40 CLOCK ON command. Once 
you have done so, perform the following steps: 

1. Establish an SRB with the following information: 

a. Function: 11 (Read Program Clock). 

2. Set up the appropriate pointer in the SRB vector and 
execute the corresponding SVC. 

3. In SAS format, save the contents of bytes 4 and 5 as a 
16-bit integer; byte 4 contains the high byte of the 
program clock. In LAS format, bytes 5 and 6 contain the 
program clock. 
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4. Execute the program segment to be timed. 

5. Execute the SVC again, as described in steps 2 and 3. 

6. Subtract the old 16-bit value from the new 16-bit value 
to obtain the execution time in 1 00-millisecond units. 

Read Binary Data from a File 

This SVC application is used to read binary data from a file. 

1. Assign the file to an available channel. 

2. Create a buffer in memory. Make sure that the buffer is 
as long as any block of data you plan to read. 

3. Establish an SRB with the following information: 

a. Function: 41 (Read Binary and Wait). 

b. Channel: the channel assigned to the file. 

c. Buffer Length: the number of bytes to be read from 
the file. 

d. Buffer Pointer: pointing to the address where the 
first byte will be placed. 

4. Establish a pointer in the SRB vector, and execute the 
corresponding SVC. 

5. Examine the status byte to verify that the SVC operated 
properly. 



Write Binary Data to a File 

This SVC application is used to write binary data to a file. 

1 . Assign the file to an available channel. 

2. Create a buffer in memory that contains the data to be 
written. 

3. Establish an SRB with the following information: 

a. Function: 42 (Write Binary and Wait), 

b. Channel: the channel assigned to the file. 

c. Buffer Length: the number of bytes to write to the 
file. 

d. Buffer Pointer: pointing to the first byte to be 
written. 

4. Establish a pointer in the SRB vector, and execute the 
corresponding SVC. 

5. Examine the status byte to verify that the SVC operated 
properly. 



Read a Single Byte from the 
System Terminal 

On ASCII reads, OS/40 waits to receive a RETURN 
character before returning control to your program. 
However, in some instances, you may want to regain 
control after each character is typed. This SVC application 
allows you to read a single byte from the system terminal 
then regain control. 



NOTE 

On a binary read, the character typed is not echoed: 
this is the responsibility of your program. Note also 
that all of the normal editing functions, such as 
BACKSPACE, are ignored for a binary read; again, it 
is the responsibility of your program to perform these 
operations on a binary read. 

1. Assign CON! (system terminal input) to an available 
Ci lannei. 

2. Establish an SRB with the following information: 

a. Function: 41 (Read Binary and Wait), 

b. Channel: the channel to which CONI is assigned. 

c. Buffer Length: 01 (this designates a single 
character to be read). 

d. Buffer Pointer: pointing to the location that the 
character is to be placed after it is read. 

3. Establish a pointer in the SRB vector, and execute the 
corresponding SVC. 

4. Examine the status byte to verify that the SVC operated 
properly. 



Write a Single Byte to the System 
Terminal 

This SVC application is used to write a single byte to the 
system terminal. On ASCII writes, OS/40 waits until it has 
written a RETURN character before returning control to 
your program. However, in some instances, you may want 
to regain control after each character is written. To write 
one character to the system terminal, perform the 
following steps: 

1 . Assign CONO (system terminal output) to an available 
channel, 

2. Create an SRB containing the following information: 

a. Function: 42 (Write Binary and Wait). 

b. Channel: the channel assigned to CONO. 

c. Buffer Length: 01 (for a single character). 

d. Buffer Pointer: pointing to the character to be 
displayed, 

3. Establish a pointer in the SRB vector, and execute the 
corresponding SVC. 

4. Examine the status byte to verify that the Svc operated 
properly. 

SVC DEMONSTRATION 

This subsection contains a demonstration program that 
illustrates some of the techniques for using SVCs. The 
program demonstrates the use of SRB pointers, SRBs, 
buffers, andfour SVCs: Assign Channel, Read ASCII, Write 
ASCII, and Abort, Figure 6-3 is a flowchart of the 
demonstration program, 
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Start 



Execute SVC 1 to 
Assign System Terminal 
to Channel 




SVC Definitions 




SVC 1 


Function 10, 


Assign channel 


SVC 2 


Function 10, 


Assign channel 


SVC 3 


Function 01 


Read ASCII 


SVC 4 


Function 02, 


Write ASCII 


SVC 5 


Function IF 


Abort 



Execute SVC 2 to 
Assign Line Printer 
to Channel 1 




Error 



Execute SVC 3 to 
Read Line from 
System Terminal 




Test 
Status 



f OK 



Error 



or End-of-File 



Execute SVC 4 to 
Write Line to 
Line Printer 



OK 




Execute SVC 5 to Exit 



End 



) 



3457-38 



Fig. 6-3. SVC demonstration program flowchart. 

This flowchart represents the algorithm for the SVC demonstration program. The instructions for the 8080A/8085A version of 
this program are given in Fig. 6-4. SVC1 and SVC2 assign the system terminal and the line printer to channels and 1, 
respectively. SVC3 reads a line and SVC4 copies it to the line printer. To stop the program, enteraCTRL-Zwhen the terminal is 
awaiting input. 
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The demonstration program is presented here in 
8080A/8085A assembly language. A similar program is 
provided in the Emulator Specifics supplement for each 



emulator supporteu uy t 



igu 



8080/8085A listing of the demonstration program. 



; SSSSS 


V V ccccc 






; s 


V V c 








; SSSSS 


V V c 


DEMONSTRATION 


8080A/8085A EMULATOR 


s 


V V c 








; SSSSS 


V c 


CCCC 








ORG 


40H 




BEGINNING OF SRB VECTOR 




BYTE 


HI (SRBIFN), 


L0( SRBIFN) 




BYTE 


HI ( SRB2FN ) , 


L0(SRB2FN) 




BYTE 


HI(SRB3FN), 


L0(SRB3FN) 




BYTE 


HI(SRB4FN), 


L0(SRB4FN) 




BYTE 


HKSRBSFN) 


L0(SRB5FN) 


; 


END OF 


SRB VECTOR 






' 


ORG lOOH 




SET UP SRB AREAS 


; 


SRBl = 


ASSIGN 'CON] 


' TO CHANNEL j 


SRBIFN 


BYTE 


lOH 




ASSIGN 




BYTE 


OOH 




TO CHANNEL 


SRBIST 


BLOCK 


OIH 




STATUS RETURNED HERE 




BLOCK 


02H 




BYTES 4 AND 5 NOT USED 




BYTE 


05H 




LENGTH OF 'CONI'+<CR> 




BYTE 


HI ( CONI ) 




POINTER TO 




BYTE 


LO(CONI) 




'CONI'+<CR> 


; 


END OF 


SRBl 






; 


SRB2 - 


ASSIGN 'LPT 


' TO CHANNEL 1 | 


SRB2FN 


BYTE 


lOH 




ASSIGN 




BYTE 


OIH 




TO CHANNEL 1 


SRB2ST 


BLOCK 


OIH 




STATUS RETURNED HERE 




BLOCK 


02H 




BYTES 4 AND 5 NOT USED 




BYTE 


04H 




LENGTH OF 'LPT'+<CR> 




BYTE 


HKLPTi 




POINTER TO 




BYTE 


LO(LPT) 




'LPT'+<CR> 


; 


END OF 


SRB2 






; 


SRB3 = 


READ ASCII LINE FROM CONI (CHANNEL 0) j 


SRB3FN 


BYTE 


OIH 




READ ASCII 




BYTE 


OOH 




FROM CHANNEL 


SRB3ST 


BLOCK 


OIH 




STATUS RETURNED HERE 




BLOCK 


OIH 




BYTE 4 NOT USED 




BLOCK 


OIH 




BYTE COUNT RETURNED HERE 




BYTE 


OOH 




256 BYTES IN OUR BUFFER 




BYTE 


HI (BUFFER) 




POINTER TO 




BYTE 


L0( BUFFER) 




OUR BUFFER 


; 


END OF 


SRB3 






; 


SRB4 = 


WRITE ASCII 


LINE TO LPT (CHANNEL 1) | 


SRB4FN 


BYTE 


02H 




, WRITE ASCII 




BYTE 


OIH 




, TO CHANNEL 1 


SRB4ST 


BLOCK 


OIH 




, STATUS RETURNED HERE 




BLOCK 


OIH 




, BYTE 4 NOT USED 




BLOCK 


OIH 




; BYTE COUNT RETURNED HERE 




BYTE 


OOH 




; 256 BYTES IN OUR BUFFER 




BYTE 


HI (BUFFER) 




; POINTER TO 




BYTE 


L0( BUFFER) 




; OUR BUFFER 


■' 


END OF 


SRB4 
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Fig. 6-4. 8080A/8085A SVC demonstration program listing (part 1 of 2) 
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SRB5 = 


ABORT (CLOSE ALL 


CHANNELS AND TERMINATE) 




SRB5FN 


BYTE 


IFH 


, ABORT 






BLOCK 


07H 


, BYTES 2 THROUGH 8 NOT USED 




; 


END OF 


SRB5 






BUFFER 


BLOCK 


lOOH 


, OUR I/O AREA 




CONI 


ASCII 


'CONI' 


, ASCII OF 'CONI' 






BYTE 


ODH 


+ <CR> 




LPT 


ASCII 


'LPT' 


, ASCII OF 'LPT' 






BYTE 


ODH 


+ <CR> 








END OF 


DATA DEFINITIONS 










BEGINNING OF EXECUTABLE CODE 






ORG 


lOOOH 


ENTRY POINT INTO PROGRAM 




START 


OUT 
NOP 


0F7H 


CALL SVCl 

TO ASSIGN 'CONI' 






LDA 


SRBIST 


CHECK THE STATUS TO SEE 






CPI 


OOH 


IF ALL WENT WF.TJ, 






JNZ 


ABORT 


NO? STOP EVERYTHING 






OUT 


0F6H 


YES? CALL SVC2 






NOP 




TO ASSIGN 'LPT' 






LDA 


SRB2ST 


CHECK THE STATUS TO SEE 






CPI 


OOH 


IF ALL WENT WELL 






JNZ 


ABORT 


NO? STOP EVERYTHING 




LOOP 


OUT 
NOP 


0F5H 


CALL SVC3 

TO READ A 'CONI' LINE 






LDA 


SRB3ST 


INTO 'BUFFER' 






CPI 


OOH 


ALL OK? 






JNZ 


ABORT 


NO? STOP EVERYTHING 






OUT 


0F4H 


CALL SVC4 






NOP 




TO WRITE 'LPT' 






LDA 


SRB4ST 


CHECK TO SEE IF 






CPI 


OOH 


ALL IS O.K. 






JZ 


LOOP 


YES? BACK TO READ ANOTHER LINE 
NO? FALL THROUGH TO TERMINATION 




ABORT 


OUT 
NOP 

HLT 


0F3H 


CALL SVC5 

TO DO THE ABORT 

SHOULD NEVER REACH HERE 






END 


START 
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Fig. 6-4. 8080A/8085A SVC demonstration program listing (part 2 of 2). 



Program Description 

The demonstration program consists of two major parts: 
the data declarations and the executable code. 



After the SRBs are defined, the I/O buffer space is 
allocated. The device names (used for channel assignment) 
are also defined. 



Data Declaration 

This part of the program begins by defining the five entries 
in the SRB vector. Each entry points to a function byte of an 
SRB. These entries are examined by OS/40 when an SVC 
is invoked. In this demonstration program, only one SRB is 
used for each SVC, so the SRB contains the number of the 
SVC as part of its labels. 



Executable Code 

This part of the program begins by invoking SVCl . This SVC 
invocation instructs OS/40 to examine the address stored 
in memory locations 40 and 41 of the SRB vector. These 
addresses point to the beginning of SRB1. SVCl assigns 
channel to CONI (system terminal input). 



O 
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After SVC1 is executed, the program checks the status 
byte. OS/40 sets this byte to indicate whether the 
operatiori was completely and properly performed. !f this 
byte is non-zerc, some unwanted result has occurred, and 
the program branches to an exit routine. 

Next, the program executes SVC2 to assign the line printer 
'LPT^ to channel 1 The "ro^ram then tests the status byte 
as before, branching to the exit routine upon any error. 

The program then initiates a read from channel 0. Because 
the system terminal input (CONI) was assigned to this 
channel, SVC3 causes the program to be delayed until a 
line has been typed in at the terminal. When the RETURN 
character has been entered, OS/40 resumes the program. 
The line is read into the buffer designated in the SRB for 
SVC3. 

The program then tests the status byte for a possible 
termination condition. This termination condition is 
indicated by a non-zero value in the status byte of SRB3. 
The program is exited when either of the following 
conditions occurs: 

• An error occurs during the I/O transfer; this generates 
the appropriate I/O error value in the status byte, or 

• A CTRL-Z is typed in at the terminal; this generates an 
end-of-file condition, and returns FF, the end-of-file 
status value. 

If neither termination condition has occurred, SVC4 
outputs the line to channel 1 (which was assigned to LPT.) 
The line itself does not need to be moved, because the same 
buffer is used for input and output. The status is checked 
again after SVC4 is completed if OS/40 indicates no error, 
the program loops back to read another line. 

When any error occurs, or CTRL-Z is entered at the 
terminal, the program branches to the exit routine. This 
routine executes SVC5, which is defined by SRB5 to 
perform an abort (stop program execution, close all open 
channels). 

NOTE 

The program in Figure 6-4 is written for a B Series 
assembler (as provided for an 8560). To modify tfiis 
program for an A Series assembler (as provided for an 
8550), change each single quote (') to a double quote 

i"\ 



SVC FUNCTIONS 

The remainder of this section describes each of the SVC 
funuliorib individuaiiy. Thefirst byteof an SRB indicates the 
function of the service call. Each function is described in 
the following format: 

Identification The name of the function being 

described, and itsfunction number. 
The function number is in byte 1 of 
the SRB at the time of the call. 



Description 



Parameters Passed 



One or more paragraphs discus- 
sing the operation of the function 
and its limits or extensions. 

A list of values that you must put 
into the SRB or buffer before the 
call is made. Because the function 
byte must always be loaded before 
any call, it is not included in this 
parameter list. 

A list of all items that OS/40 will 
return in the various parts of the 
SRB and buffer. Becausethe status 
byte is always returned, it is not 
included in the list unless it has a 
special significance. 

The functions are described in alphabetic order, Refer to 
the Section 6 Table of Contents for a numeric index of the 
functions. The following paragraphs briefly define the 
terms used in these descriptions 



Information 
Returned 



Terminology 



ASCII and binary are two types of data transfers. An ASCII 
transfer consists of a single line of text containing zero to 
255 characters, followed by a RETURN character. The most 
significant bit of each character is cleared on any ASCII 
transfer. 

A binary transfer consists of 1 to 256 bytes; the length of 
the data item is determined only by the buffer size. The 
most significant bit of each byte is not affected during a 
binary transfer 

Under OS/40, proceed SVCs are equivalent to wait SVCs: 
both complete the I/O operation before your program is 
allowed to continue. 
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SVC Function— Create File 







Bytes 


Used 




Small Add 


ress 


Large Address 


SRB Field 


Space Format 


Space Format 


Name 


(SAS) 




(LAS) 


Function 


1 




1 


Channel 


2 




2 


Status 


3 




3 


Fourth Byte 


4 




4 


Byte Count 


5 




5-6 


Buffer Length 


6 




7-8 


Buffer Pointer 


7-8 




9-12 



Under OS/40, overwrite SVCs are equivalent to write 
SVCs: both operations set an end-of-filemarkthat destroys 
any information past that point in the file. 

The file pointer is a logical position in the file. All reads 
from the file and writes to the file are performed beginning 
at the current file pointer. The file pointer is updated to the 
end of the data item read or written. Seek SVCs reposition 
the file pointer. An independent file pointer is maintained 
for each channel. 

NOTE 

When the Byte Count, Buffer Length, and Buffer 
Pointer fields are used for non-1/0 operations, they 
are discussed by byte number. 

Differences between SAS and LAS formats are noted 
in the function descriptions. 

On all two-byte and four-byte values used by SVCs, 
the high byte is given first. 



Assign Channel— Function 10 

This function assigns a file or device to the designated 
channel. Store the filespec (terminated by a RETURN 
character) in the buffer before invoking this SVC. If you 
designate a file that does not already exist, the file is 
created. 



Parameters Passed 

Buffer. Contains the filespec, terminated by a RETURN 

character. 

Channel. The channel number assigned to the file or 

device designated by the filespec. 

Buffer Pointer. The location of the first byte of the buffer. 



Information Returned 

None. 



Close Channel— Function 03 

This function closes a previously opened channel. 

Parameters Passed 

Channel. The channel to be closed. 



Information Returned 

None. 



Abort Program— Function 1 F 

This function terminates the currently running program. 
All open channels are automatically closed. 

NOTE 

If this SVC is executed when TRAce is off, the 
program counter will contain the address where 
execution began on the most recent G command. 

A ny errors that result from closing the open channels 
are displayed on the system terminal. 

Parameters Passed 

None. 



Information Returned 

None. 



Create File— Function 90 

This function creates an empty file with the specified 
filespec, and assigns a channel to the new file. If the 
specified file already exists, its previous contents are lost. 



Parameters Passed 

Buffer. The filespec of the file to be created, terminated by 

a RETURN character. 

Channel. The channel number to which the file will be 

assigned. 

Buffer Pointer. The location of the first byte of the buffer. 



Information Returned 

None. 
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Bytes 


Used 




Small Address 


Large Address 


SnB Field 


Space Format 


Space Format 


Name 


(SAS) 


L (LAS) 


Function 


1 


1 


Channel 


2 


2 


Status 


3 


3 


Fourth Byte 


4 


4 


Byte Count 


5 


5-6 


Buffer Length 


6 


7-8 


Buffer Pointer 


7-8 


9-12 



Exit Program— Function 1A 

This function stops the execution of your program. 08/40 
will respond with a prompt for another command. Use the 
G command to resume execution. (Do not use the CO 
command in this situation.) Any channels currently open 
remain open. This function is identical to the Suspend 
Program SVC (function 19). 



Parameters Passed 

None. 



Information Returned 

None. 



Get Command Line Parameter- 
Function 13 

This function (identical to the Get Execution Line 
PatafTieter SVC, function 1C) returns a parameter of the 
command line used to load or execute the current program. 
The parameters are numbered with consecutive non- 
negative integers, beginning with 01 . For example, for the 
OS/40 command line "X<MYFILEVWX+3",parameter01 
is V and parameter 03 is X+3. The selected parameter is 
returned in the buffer. If the parameter number is greater 
than the number of parameters in the command line, the 
value FF is returned in the buffer in place of a parameter. 

Parameters Passed 

SAS Byte 4, LAS Bytes 5-6. The number of the requested 

parameter. 

Buffer Length. The maximum number of characters in the 

parameter. 

Buffer Pointer. The location of the first byte of the buffer. 



information Returned 

Buffer. The parameter, terminated by a RETURN character. 

RETURN character. This information is not returned in LAS 
format. 



Get Device Type— Function 14 

This function returns two device-dependent values that 
define the type and general capabilities of the device or file 
assigned to the designated channel. Table 6-2 lists the 
values that are associated with each device. 



!n TERM mode, CONI and CONG are treated as files (device 
identification FF, type code 43). 



Parameters Passed 

Channei. The channel number to which the device or file is 
currently assigned. 



Information Returned 

SAS Byte 4, LAS Byte7. The device identification number 
(as defined in Table 6-2). 

SAS Byte 5, LAS Byte 8. The device type code (as defined 
in Table 6-2). 



Get Execution Line Parameter- 
Function 1C 

This function is identical to the Get Command Line 
Parameter SVC, function 13. 



Get Last CONI Character- 
Function 16 

This function returns the ASCII value of the last character 
entered at the system terminal. 

Parameters Passed 

None. 
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SVC Function— Log Error Message 







Bytes 


Used 




Small Add 


ress 


Large Address 


SRB Field 


Space Format 


Space Format 


Name 


(SAS) 




(LAS) 


Function 


1 




1 


Channel 


2 




2 


Status 


3 




3 


Fourth Byte 


4 




4 


Byte Count 


5 




5-6 


Buffer Length 


6 




7-8 


Buffer Pointer 


7-8 




9-12 



is loaded with a specified bias (offset) from each of its 
addresses. The bias is specified in the bytes following the 
buffer pointer, and is added to the starting address of each 
block in the load file. 



Parameters Passed 

Buffer. The filespec, terminated by a RETURN character. 
Buffer Pointer. The location of the first byte of the buffer. 
SAS Bytes 9-1 0, LAS Bytes 1 3-1 6. The bias (high byte 
first) to be added to the starting address of each block in the 
load file. 



Information Returned 

SAS Byte 4, LAS Byte 6. The last character entered at the 
system terminal. 



Information Returned 

SAS Bytes 4-5, LAS Bytes 5-8. The transfer address of 
the load file: the high-order byte is given first. 



Load Overlay— Function 17 

This function loads a load file (in A Series or B Series Load 
Module format) into program or prototype memory. The 
buffer must contain the name of the file when the SVC is 
invoked. 



Parameters Passed 

Buffer. The filespec, terminated by a RETURN character. 
Buffer Pointer. The location of the first byte of the buffer. 



Information Returned 

SAS Bytes 4-5, LAS Bytes 5-8. The transfer address of 
the load file: the high-order byte is given first. 



Load Overlay with Bias- 
Function 57 

This function loads a load file (in A Series or B Series Load 
Module format) into program or prototype memory. The file 



Log Error Message— Function 09 

This function displays an error message on the system 
terminal. (All system error messages are listed in the Error 
Messages section of this manual.) The message includes 
the name of the last program loaded; this identifies thatthe 
message was generated by a user program. 

Use this SVC when your program is not prepared to handle 
the error. You can use the sameSRBthatreturned the error 
code by changing the function byte. 



Parameters Passed 

Status. The error message number returned by the 
previous call for this SRB. 

Information Returned 

None. 



Table 6-2 
Device Identification and Type 







Device 






Name 


Description 


Identification 


Type Code 


Type Description 


CONI 


Console input 


01 


01 


ASCII read 


CONO 


Console output 


02 


02 


ASCII write 


LPT 


Line printer 


03 


02 


ASCII write 


PPTR 


Paper tape reader 


08 


01 


ASCII read 


PPTP 


Paper tape punch 


09 


02 


ASCII write 


REMI 


Remote input 


OA 


01 


ASCII read 


REMO 


Remote output 


OB 


02 


ASCII write 


(file) 


File 


FF 


43 


Binary read/write 



o 
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Bytes Used 




Small Add 


ress 


Large Address 


SRB Field 


Sngrp ForfTSat 




Name 


(SAS) 




(LAS) 


Function 


1 




1 


Channel 


2 




2 


Status 


3 




3 


Fourth Byte 


4 




4 


Byte Count 






5-6 


Buffer Length 


6 




7-8 


Buffer Pointer 


7-8 




9-12 



Open for Read— Function 30 

This function assigns an existing file or device to the 
designated channel. An error is generated if the file or 
device does not exist, or if a write to the channel is 
attempted later. 



Parameters Passed 

Buffer. The filespec, terminated by a RETURN character. 

Channel. The channel number to which the file is 

assigned. 

Buffer Pointer. The location of the first byte of the buffer. 

Information Returned 

None. 



Parameters Passed 

Buffer. The filespec, terminated by a RETURN character. 

Channel. The channel number to which the filespec is 

assigned. 

Buffer Pointer. The location of the first byte of the buffer. 

information Returned 

None. 



Overwrite ASCII and Proceed— 
Function A2 

This function is identical to the Write ASCII and Wait SVC, 
function 02. 



Overwrite ASCII and Wait- 
Function 22 

This function is identical to the Write ASCII and Wait SVC, 

f I inrtinn HO 



Overwrite Binary and Proceed— 
Function E2 

This function is identical to the Write Binary and Wait SVC, 
function 42. 



Open for Read or Write— 
Function 70 

This function assigns an existing file or device to the 
designated channel. An error is generated if the file or 
device does not exist. 



Overwrite Binary and Wait- 
Function 62 

This function is identical to the Write Binary and Wait SVC. 
function 42. 



Parameters Passed 

Buffer. The filespec, terminated by a RETURN character. 

Channel. The channel number to which the file is 

assigned. 

Buffer Pointer. The location of the first byte of the buffer. 



Read ASCII and Proceed— 
Function 81 

This function is identical to the Read ASCII and Wait SVC, 
function 01. 



Information Returned 

None. 



Open for Write— Function 50 

This function assigns an existing file or device to the 
designated channel. An error is generated if the file or 
device does not exist, or if a read from the channel is 
attempted later 



Read ASCII and Wait- 
Function 01 

This function reads one ASCII line from the designated 
channel into the buffer. 

Parameters Passed 

Channel. The channel assigned to the device or file from 
which the line is read. 
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Bytes 


Used 




Small Address 


Large Address 


SRB Field 


Space Format 


Space Format 


Name 


(SAS) 


(LAS) 


Function 


1 


1 


Channel 


2 


2 


Status 


3 


3 


Fourth Byte 


4 


4 


Byte Count 


5 


5-6 


Buffer Length 


6 


7-8 


Buffer Pointer 


7-8 


9-12 



Buffer Length. The maximum number of characters to 

read, including the RETURN character. 

Buffer Pointer. The location of the first byte of the buffer. 



Information Returned 

Byte Count. The number of characters read, including the 
RETURN character. 

Buffer. The ASCII line read, including the RETURN 
character. 



Read Binary and Proceed— 
Function CI 

This function is identical to the Read Binary and Wait SVC, 
function 41. 

Read Binary and Wait- 
Function 41 

This function reads binary data from the designated 
channel into the buffer. 

Parameters Passed 

Channel The channel assigned to the file or device from 

which the buffer is read. 

Buffer Length. The number of bytes to read. 

Buffer Pointer. The location of the first byte of the buffer. 

Information Returned 

Byte Count. The number of bytes actually read; the same 
as buffer length, unless the end-of-file was reached. 
Buffer. The bytes read. 



Parameters Passed 

None. 



Information Returned 



SAS Bytes 4-5, LAS Bytes 5-6. The 1 6-bit program clock; 
the high-order byte is given first. 



Rewind File— Function 04 

This function moves the file pointer to the beginning of the 
file assigned to the designated channel. 



Parameters Passed 

Channel The channel number of the file to rewind. 

Information Returned 

None. 



Seek Relative to Byte in File- 
Function 24 

This function seeks to a byte in the file assigned to the 
designated channel. The byte number is given as a signed 
4-byte value. The first byte of the file is byte number 0; 
successive bytes are numbered in ascending order. 

An offset from the current file pointer is given as a signed 4- 
byte value. This offset is added to the current file pointer to 
produce the new file pointer. 

The new file pointer is returned to verify that it has indeed 
been located at the requested position; the new position 
cannot be beyond the current end-of-file, nor before the 
beginning of the file. To obtain the value of the current file 
pointer, pass an offset of 00000000 to this SVC. 



Parameters Passed 

Channel The channel assigned to the file on which the 
seek is performed. 

SAS Bytes 5-8, LAS Bytes 9-12. A signed 4-byte value 
(most significant byte first) containing the offset to add to 
the current file pointer. 



Read Program Clock— Function 1 1 information Returned 



This function reads the 08/40 program clock, which is a 
1 6-bit counter controlled by the OS/40 CLOCK command. 



SAS Bytes 5-8, LAS Bytes 9-1 2. The new position of the 
file pointer. 
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Bytes Used 


Name 


Small Address 
c^-»^^ c^ * 

(SAS) 


Large Address 
■jipace > ormat 

(LAS) 


Function 
Channel 
Status 
Fourth Byte 
Byte Count 
Buffer Length 
Buffer Pointer 


1 
2 
3 
4 
5 
6 
7-8 


1 

2 

3 

4 
5-6 
7-8 
9-12 



Seek to Byte in File— Function 44 

This function seeks to a byte in the file assigned to the 
designated channel. The byte number is given as a signed 
4-byte value. The first byte of the file is byte number 0; 
successive bytes are numbered in ascending order. 

The new file pointer is returned to verify that it has indeed 
been located at the requested position. The new position 
cannot be beyond the current end-of-file, or before the 
beginning of the file. 

A seek to byte is equivalent to the Rewind SVC, function 
04. 



Parameters Passed 

Channel. The channel assigned to the file on which the 
seek is performed. 

SAS Bytes 5-8, LAS Bytes 9-12. A signed 4-byte value 
(most significant byte first) containing the byte position to 
seek to. 



You may position the file pointer at the end-of-fi!e without 
knowing the file's length; to do so, pass a value of 
00000000 to this SVC. After this seek operation, you may 
append additional information to the file. 

The new file pointer is returned to verify that it has indeed 
been located at the requested position; the new position 
cannot be beyond the current end-of-file, or before the 
beainnina of the file. 



Parameters Passed 

Channel. The channel assigned to the file on which the 
seek is performed. 

SAS Bytes 5-8. LAS Bytes 9-12. A signed 4-byte value 
(most significant byte first) containing the offset. This offset 
is added to the number of bytes in the file to obtain the new 
value of the file pointer. 



Information Returned 

SAS Bytes 5-8. LAS Bytes 9-1 2. The new position of the 
file pointer. 



Special Function — Function 07 

This function performs a special device-dependent 
operation on the device or file currently assigned to the 
designated channel. At the time of this writing, only one 
special function code (14) is defined. Its action is identical 
to the Get Device Type SVC (function 14). Other special 
functions mav be defined at some future date. 



Parameters Passed 



Information Returned 

SAS Bytes 5-8, LAS Bytes 9-1 2. The new position of the 
file pointer; should be the same as the position passed, 
unless a seek is attempted past the beginning or the end of 
the file. 



Seek to Byte in File Relative to 

rr\i- r- a: /> m 

cv-rr — runuLiuii oh- 

This function seeks to a byte in the file assigned to the 
designated channel. An offset from the current end-of-file 
is given as a signed 4-byte value (usually zero or negative). 



Channel. The channel number assigned to perform the spe- 
cial function. 

SAS Byte 5, LAS Bytes 5-6. The special function code (cur- 
rently defined only for 14). 

Information Returned 

(Dependent on special function.) 

Suspend Program— Function 19 

This function is identical to the Exit Program SVC, function 
1A. 
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Bytes Used 




Small Add 


ress 


Large Address 


SRB Field 


Space Format 


Space Format 


Name 


(SAS) 




(LAS) 


Function 


1 




1 


Channel 


2 




2 


Status 


3 




3 


Fourth Byte 


4 




4 


Byte Count 


5 




5-6 


Buffer Length 


6 




7-8 


Buffer Pointer 


7-8 




9-12 



Information Returned 

Byte Count. The number of characters written. 



Write Binary and Proceed— 
Function C2 

This function is identical to the Write Binary and Wait SVC, 
function 42. 



Write ASCII and Proceed— 
Function 82 

This function is identical to the Write ASCII and Wait SVC, 
function 02. 



Write ASCII and Wait- 
Function 02 

This function writes one ASCII line from the buffer to the 
designated channel. 



Write Binary and Wait- 
Function 42 

This function writes binary data from the buffer to the 
designated channel. 

Parameters Passed 

Buffer. The binary data to be written to the channel. 
Channel. The channel assigned to the file or device to 
which the buffer is written. 

Buffer Length. The number of bytes to be written. 
Buffer Pointer. The location of the first byte of the buffer. 



Buffer Length. The maximum number of characters to be 
written; this count Includes the RETURN character. 
Buffer Pointer. The location of the first byte of the buffer. 



Information Returned 

Byte Count. The number of bytes actually written; should 
be the same as buffer length. 
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Section 7 
EMULATOR SPECIFICS 



Processor-specific information is contained in the Emulator 
Specifics supplement that accompanies each emulator. Each 
supplement is designed to be inserted into this manual. 

These Emulator Specifics supplements are numbered as if 
they were separate sections of this manual. For example, 
the 8080A supplement is labeled "Section 7A," and the 
first illustration is numbered "Fig. 7A-1." Similarly, other 
supplements are labeled Sections 7B, 7C, etc. Figures, 
pages, and tables are numbered accordingly. 

Each supplement presents the following information: 

• A general summary of the emulator's capabilities. 

• OS/40 commands, parameters, and displays that are 
specific to that emulator. 



• Service call (SVC) information for that emulator, 
including a sample program parallel to the 8080A/ 
8085A program presented in the Service Calls section of 
this manual. 

• Any special considerations that should be noted. 

• Timing discrepancies between the prototype control 
probe and the microprocessor that it replaces. 

• A demonstration run that parallels the one in the 
Learning Guide of this manual. 

Each supplement has its own table of contents. 



® 
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Section 7C 
Z80 EMULATOR SPECIFICS 



INTRODUCTION 

This section supports the Z80A Emulator Processor and Prototype Control Probe as well as the newer Z80B 
Emulator Processor and Probe. While the Z80A Emulator Processor can emulate only Z80 and Z80A 
microprocessors, the Z80B Emulator Processor can emulate the Z80, Z80A, and Z80B microprocessors. 



In this section, the term "Z80 emulator" is used in presenting information that applies to both the older Z80A 
emulator and the newer Z80B emulator. The term "Z80A emulator" is used for information that applies only 
to the Z80A Emulator Processor. The term "ZSOB emulator" is used for information that applies only to the 
newer Z80B Emulator Processor. 



This Emulator Specifics section is to be inserted into Section 7 of the 8550 System Users Manual (DOS/50 
Version 2) or the 8540 System Users Manual. It explains the features of the 8550 and 8540 systems that are 
unique to the Z80A and Z80B Emulators. Throughout the section, "your System Users Manual" refers to the 
8550 System Users Manual or 8540 System Users Manual. The Z80 Demonstration Run is designed to be 
used with Section 1 (the Learning Guide) of your System Users Manual; the rest of this section contains 
reference material. 



GENERAL INFORMATION 



Emulator Hardware Configuration 

Throughout this Emulator Specifics section, the term ''Z80 emulator" refers to a Z80 Emulator Processor 
boad configured with a Z80 Prototype Control Probe or mobile microprocessor. In emulation Mode 0, the 
mobile microprocessor may be inserted directly into the emulator board. In Modes 1 and 2, the mobile 
microprocessor must be installed in the prototype control probe and the prototype control probe must be 
connected to both the emulator and your prototype. For instruction on installing the emulator board, mobile 
microprocessor, and probe, refer to the Z80 Emulator Processor and Prototype Control Probe Installation 
Service Manual. 



Microprocessors Supported 

The Z80A emulator emulates the Zilog, Z80 and Z80A microprocessors. The Z80B emulator emulates the 
Zilog Z80, Z80A, and Z80B microprocessors. 

Emulation Modes 

The Z80 emulator supports Emulation Modes 0, 1, and 2, as described in the Emulation section of your 
System Users Manual. The Z80 emulator supports service calls (SVCs) in all three modes. 
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Z80A Clock Rate 

In Mode emulation, the emulator clock rate is 2 or 4 MHz, depending on the setting of jumper J1 . In Mode 
1 emulation, the maximum recommended rate for the prototype clock is 4 MHz. 



Z80B Clock Rate 

In Mode emulation, the emulator clock rate is 4 or 6 MHz, depending on the setting of jumper J3002. In 
Mode 1 emulation, the clock rate of 6 MHz may be used only with 8500-series systems. At this 6 MHz rate, 
one wait state will be inserted. 



NOTE 

When used with the Trigger-Trace Analyzer (TTA) or the Real-Time Prototype Analyzer (RTPA), the 
Z80B Emulator Processor provides an output that is one-half of the emulator operating clock rate. 
Therefore, the clock count stored in the TTA or RTPA buffers will be one-half of the actual emulator 
clock count. 



Symbolic Debug 

The Z80 emulator supports the use of symbolic debug. 



EMULATOR-SPECIFIC COMMANDS, PARAMETERS, AND 
DISPLAYS 



SEL — Selecting an Emulator 



The SEL (SELect) command allows you to select the emulator you want to use with your system. The 
following command line selects the Z80 emulator and assembler: 

> SEL Z80 



Byte/Word Parameter 

Several commands offer you the choice of operating on memory on a byte-oriented or word-oriented basis. 
In affected commands, this choice is represented by the — B or — W parameter. For the ZBO emulator, the 
default value is — B (Byte). 



MAP — Mapping Memory 

The ZBO addresses a 64 K memory space, arranged in 512 blocks of 128 bytes each. The MAP command 
enables you to assign blocks of memory to either program memory or prototype memory, and to designate 
blocks of program memory as read-only. Refer to the Command Dictionary for details on the syntax, param- 
eters, and use of the MAP command. 
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Setting Breakpoints 

The Z80 emulator allows you to specify up to two breakpoints with the BK command. 

Memory Allocation Commands 

The Memory Allocation Controller (MAC) option cannot be used with the Z80 emulator. The Z80 does not 
use the MEMSP command, and does not support memory space qualifiers or expressions. The Z80 emula- 
tor supports the AL (ALIocate) command, as described in the Command Dictionary of your System Users 
Manual. The DEAL, MEM, and NOMEM commands are not supported. 

Port Commands 

The Z80 emulator does not support the RD or WRT commands. 

CONS Command Modes 

The Z80 emulator supports the FET mode of the CONS command of the Trigger Trace Analyzer. The Z80 
does not support the EMU mode of the CONS command. 

Register Designators 

Table 7C-1 alphabetically lists the symbols used by DOS/50 and OS/40 to designate the registers and flags 
used by the Z80. The table provides the following information for each symbol: 

• a description of the register or flag that the symbol represents; 

• the size of the register or flag; 

• the value assigned to the register or flag by the RESET command; 

• whether the register or flag can be assigned a value by the S (Set) command. 

Figure 7C-1 shows the contents of the Z80 flag register. 
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Table 7C-1 
Z80 Registers and Flags 







Size in 


Value After 


Alterable 






Bits 


RESEr 


byS 


Symbol 


Description 






Command? 


A 


Register A 


8 


NC 


yes 


AA 


Alternate register A 


8 


NC 


yes 


AB 


Alternate register B 


8 


NC 


yes 


ABC 


Alternate registers B & C 


16 


NC 


yes 


AC 


Alternate register C 


8 


NC 


yes 


AD 


Alternate register D 


8 


NC 


yes 


ADE 


Alternate registers D & E 


16 


NC 


yes 


AE 


Alternate register E 


8 


NC 


yes 


AF 


Alternate flag register 


8 


NC 


yes 


AH 


Alternate register H 


8 


NC 


yes 


AHL 


Alternate registers H & L 


16 


NC 


yes 


AL 


Alternate register L 


8 


NC 


yes 


B 


Register B 


8 


NC 


yes 


BC 


Registers B & C 


16 


NC 


yes 


C 


Register C 


8 


NC 


yes 


CY 


Carry flag ^ 


1 


NC 


yes 


D 


Register D 


8 


NC 


yes 


DE 


Registers D & E 


16 


NC 


yes 


E 


Register E 


8 


NC 


yes 


F 


Flag register ^ 


8 


NC 


yes 


H 


Register H 


8 


NC 


yes 


HC 


Auxiliary carry flag ^ 


1 


NC 


yes 


HL 


Registers H & L 


16 


NC 


yes 


1 


Interrupt page address register 


8 


00 


yes 


IFF1 


Interrupt flip-flop 1 


1 





yes'^ 


IFF2 


Interrupt flip-flop 2 


1 





yes'' 


IM 


Interrupt mode 


1 





yes 


IX 


Index register X 


16 


NC 


yes 


lY 


Index register Y 


16 


NC 


yes 


L 


Register L 


8 


NC 


yes 


N 


Subtract flag ^ 


1 


NC 


yes 





Overflow flag ^ 


1 


NC 


yes 


P 


Parity flag ^ 


1 


NC 


yes 


PC 


Program counter 


16 


0000 


no 


R 


Memory refresh register 


8 


00 


yes 


S 


Sign flag ^ 


1 


NC 


yes 


SP 


Stack pointer 


16 


NC 


yes 


Z 


Zero flag ^ 


1 


NC 


yes 



^ NC = not changed by RESET 

'' The flag register is illustrated in Fig. 7C-1. 

*= The S command performed on either IFF1 or IFF2 sets both. 
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HC 



P/0 N 



■ carry bit = 1 if carry 

• subtract bit = 1 if subtract 

. parity/overflow bit = 1 if even 
parity or overflow condition 

• not used 

.auxiliary-carry bit = 1 
if auxiliary-carry 

not used 

zero bit = 1 if zero 

sign bit = 1 if negative 



3964-1 



Fig. 7C-1. Flag register bit configuration in the Z80 emulator. 



BUS and EVE — Bus Operation Designators 

Table 7C-2 lists the Z80 bus operation designators recognized by the Trigger Trace Analyzer's BUS com- 
mand, and for the B parameter of the EVE command. 



Table 7C-2 
Z80 Bus Operation Designators 



Symbol 


Bus Operation Type 


CLR 


All types 


F 


Instruction Fetches 


NF 


Non-fetches 


M 


Memory accesses 


RD 


Reads 


WT 


Writes 


1 


I/O operations 
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DS — Sample Z80 Emulator Status Display 

The DS (Display Status) command displays the status and register contents of the Z80. All numbers in the 
DS display line are hexadecimal. 



Here is an example of a DS display line for the Z80 emulator: 

> DS 

PC=0000 SP=5645 F=43 A=C3 B=02 C=04 D=04 E=24 H=01 L=32 

IX=1111 IY=2222 AF=00 AA=00 AB=20 AC=30 AD=40 AE=50 AH=60 AL=70 

IFF1=0 IFF2=0 IM=0 1=00 R=00 



Table 7C-1 explains the symbols displayed by the DS command. 



For the Z80 emulator, the short and long forms of the DS display are the same: DS gives the same display 
as DS -L 



RESET— Resetting Z80 Emulator Status 

The RESET command produces a hardware reset signal to the Z80 microprocessor. The Z80 registers are 
reset to the values indicated in Table 7C-1 . 



Example. Suppose the DS command returns the following emulation status: 

> DS 

FC=0100 SP=5645 F=43 A=C3 B=02 0=04 D=04 E=24 H=01 L=32 
IX=1111 IY=2222 AF=00 AA=00 AB=20 AC=30 AD=40 AE=50 AH=60 AL=70 
IFF1=1 IFF2=1 IM=1 1=01 R=01 



Enter the RESET command. Then check the status again with the DS command: 

> RESET 

> DS 



PC=0000 SP=5645 F=43 A=C3 B=02 0=04 D=04 E=24 H=01 L=32 
IX=1111 IY=2222 AF=00 AA=00 AB=20 A0=30 AD=40 AE=50 AH=60 AL=70 
IFF1=0 IFF2=0 IM=0 1=00 R=00 



t t t t t 

The arrows show the changed registers. 
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Dl — Sample Z80 Disassembled Code 

The Dl (Disassemble) command translates object code In memory into assembly language instructions. Dl 
displays object code, assembly language mnemonics, and operands. Use the Dl command to verify that the 
values In memory correspond to the assembly language instructions of your program. 



Here Is an example of Z80 Dl command output: 

> PI 100 lOE 

LOG INST MNEM OPER 

210005 LD HL,0500 

0605 LD B,05 

AF XOR A 

86 ADD A,(HL) 

23 INC HL 

05 DEC B 

C20601 JP NZ,0106 

D3F7 OUT (F7),A 



000100 
000103 
000105 
000106 
000107 
000108 
000109 
OOOIOC 
OOOIOE 



00 

i 



NOP 



I 



operand (s): address, register, or data 
being operated on 

instruction mnemonic 

machine language instruction 

address of the instruction 



TRA— Sample Z80 TRAce Display 

The TRA (TRAce) command selects the range and type of instructions to be displayed as your program 
executes. With the Z80 emulator, the TRA -N format is the same as the TRA -L format. 



NOTE 

When TRAce conditions have been set, the emulator runs at slower than normal processing speeds 
and RTF A breakpoints are suppressed. 
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Here is an example of Z80 TRA command output: 

> TRA ALL 



> G 100 
LOG 

000100 
000103 
000105 
000106 
000107 
000108 
000109 
000106 
000107 
000108 
000109 



INST 

210005 

0605 

AF 

86 

23 

05 

C20601 

86 

23 

05 

C20601 



MNEM 

LD 

LD 

XOR 

ADD 

INC 

DEC 

JP 

ADD 

INC 

DEC 

JP 



OPER 

HL,0500 

B,05 

A 

A, (HL) 

HL 

B 

NZ,0106 

A , ( HL ) 

HL 

B 

NZ,0106 



SP 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 



F 

06 

06 

46 

02 

02 

12 

12 

06 

06 

16 

16 



A 

OF 

OF 

00 

01 

01 

01 

01 

03 

03 

03 

03 



B 

01 

05 

05 

05 

05 

04 

04 

04 

04 

03 

03 



C 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 



D 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 



E 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 



H 



05 
05 
05 
05 
05 
05 
05 
05 
05 
05 



A B C D E H 
contents of registers 

flag register contents 

stack pointer contents 

■operand of the instruction 
mnemonic of the instruction 
machine language instruction 

' address of the instruction 



L 
nn 

00 
00 
00 
01 
01 
01 
01 
02 
02 
02 



IX 

0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 



lY 

0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 



ndex 

register 

Y 

index 

register 

X 
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SERVICE CALLS 

Service calls (SVCs) enable your program to use many system capabilities of your 8540, 8550, or 8560. 



An SVC is invoked with a Z80 OUT instruction. The operand of the OUT instruction directs the system to a 
specified memory address called the SRB pointer (which points to the SRB — the Service Request Block). 
The SRB pointer tells the system where to find the data (stored in the SRB) that informs the system which 
function to perform. Refer to the Service Calls section of your System Users Manual for an explanation of 
service calls, service request blocks, and SRB pointers. 



Your program can point to eight SRBs at any one time. As your program executes, it can store new 
addresses in the SRB vector. Table 7C-3 shows the default addresses for the eight SRB pointers. These 
addresses and their associated port numbers can be altered with the SVC command to suit your program 
requirements. See the Command Dictionary section of your System Users Manual for syntax and use of the 
SVC command. 



SVCs in Modes 1 and 2 

The Z80 emulator supports SVCs in Emulation Modes 1 and 2, as described in the Service Calls section of 
your System Users Manual. In Mode 2, all parts of the SVC must reside in prototype memory. 



NOTE 

In Mode and 1, use one NOP instruction immediately following the OUT instruction. In Mode 2, use 
two NOP instructions immediately following the OUT instruction; this allows time for the SVC to occur. 



SRB Format 

The Z80 emulator uses the SAS (Small Address Space) format for SRBs and the SRB vector. This format is 
described in the Service Calls section of your System Users Manual. 



SVC Demonstration 

Figure 7C-2 lists a Z80 program that uses four SVC functions: Assign Channel, Read ASCII, Write ASCII, 
and Abort. The program's algorithm is explained in the Service Calls section of your System Users Manual, 
which demonstrates a version of the program written in 8085A assembly language. You can perform a 
parallel demonstration with the Z80 emulator and Z80 A Series Assembler using the program in Fig. 7C-2. 
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Table 7C-3 
Z80 Service Calls 





Z80 Service Calls 


Default Address of 


SVC Number 


mnemonic^ 


hexadecimal 


SRB pointer 


1 


OUT (0F7H),A NOP 


D3F7 00 


40, 41 


2 


OUT (0F6H),A NOP 


D3F6 00 


42,43 


3 


OUT (0F5H),A NOP 


D3F5 00 


44,45 


4 


OUT (0F4H),A NOP 


D3F4 00 


46,47 


5 


OUT (0F3H),A NOP 


D3F3 00 


48,49 


6 


OUT (0F2H),A NOP 


D3F2 00 


4A, 4B 


7 


OUT(0F1H),ANOP 


D3F1 00 


40, 4D 


8 


OUT {OFOH),A NOP 


D3F0 00 


4E, 4F 



°You can use an IN instruction (opcode DB) in place of each OUT instruction given in Table 7C-3. 



NOTE 

The program shown in Fig. 7C-2 is written for an A Series assembler (as provided for the 8550). To 
maf<e this acceptable for a B Series assembler (as provided for the 8560), change each double quote 
(") to a single quote ('). This program shows the use of four service calls. The program's algorithm is 
explained in the Service Calls section of your System Users Manual. The program accepts a line of 
ASCII characters from the system terminal; then, when it receives a RETURN character, the program 
writes the line to the line printer and accepts another line. (On the 8550, output to the line printer is 
buffered. No text is printed until the line printer buffer in the 8501 t>ecomes full or the program ends.) 
To terminate the program, enter a CTRL-Z while the program is waiting for input. 
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sssss 


Y V 


ccccc 






s 


V V 


c 






sssss 


V V 


C DEMONSTRATION. Z80 EMULATOR 




s 


V V 


C 






sssss 


V 


CCCCC 






ORG 


40H 


; BEGINNING OF SRB VECTOR 




BYTE 


HI(SRB1FN), 


L0(SRB1FN) 




BYTE 


HI(SRB2FN) 


L0(SRB2FN) 




BYTE 


HI(SRB3FN) 


L0(SRB3FN) 




BYTE 


HI(SRB4FN) 


L0(SRB4FN) 




BYTE 


HI(SRB5FN) 


L0(SRB5FN) 


5 


END OF 


SRB VECTOR 






ORG 100H 


; SET UP SRB AREAS 


> 


SRB1 = 


ASSIGN "CON] 


:" TO CHANNEL 


SRB1FN 


BYTE 


10H 




; ASSIGN 




BYTE 


OOH 




, TO CHANNEL 


SRB1ST 


BLOCK 


01H 




; STATUS RETURNED HERE 




BLOCK 


02H 




BYTES 4 AND 5 NOT USED 




BYTE 


05H 




LENGTH OF "CONI"+<CR> 




BYTE 


HI(CONI) 




POINTER TO 




BYTE 


LO(CONI) 




"CONI"+<CR> 


> 


END OF 


SRB1 




> 


SRB2 = 


ASSIGN "LPT' 


TO CHANNEL 1 


SRB2FN 


BYTE 


10H 




; ASSIGN 




BYTE 


01H 




; TO CHANNEL 1 


SRB2ST 


BLOCK 


01H 




; STATUS RETURNED HERE 




BLOCK 


02H 




BYTES 4 AND 5 NOT USED 




BYTE 


04H 




; LENGTH OF "LPT"+<CR> 




BYTE 


HI (LPT ) 




POINTER TO 




BYTE 


lo(lpt) 




"LPT"+<CR> 


y 


END OF 


SRB2 




f 


SRB3 = 


READ ASCII LINE FROM CONI (CHANNEL O) 


SRB3FN 


BYTE 


01H 




READ ASCII 




BYTE 


OOH 




FROM CHANNEL 


SRB3ST 


BLOCK 


01H 




STATUS RETURNED HERE 




BLOCK 


01H 




BYTE 4 NOT USED 




BLOCK 


01H 




BYTE COUNT RETURNED HERE 




BYTE 


OOH 




256 BYTES IN OUR BUFFER 




BYTE 


HI (buffer) 




POINTER TO 




BYTE 


LO (buffer) 




OUR BUFFER 


5 


END OF 


SRB3 




f 


SRB4 = 


WRITE ASCII 


LINE TO LPT (CHANNEL 1 ) 


SRB4FN 


BYTE 


02H 




WRITE ASCII 




BYTE 


01H 




TO CHANNEL 1 


SRB4ST 


BLOCK 


01H 




STATUS RETURNED HERE 




BLOCK 


01H 




BYTE 4 NOT USED 




BLOCK 


01H 




BYTE COUNT RETURNED HERE 




BYTE 


OOH 




256 BYTES IN OUR BUFFER 




BYTE 


HI (buffer) 




POINTER TO 




BYTE 


LO (buffer) 




OUR BUFFER 


> 


END OF 


SRB4 
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t 


SRB5 = 


ABORT (CLOSE ALL CHANNELS AND TERMINATE) 


SRB5FN 


BYTE 


1FH ; 


ABORT 




BLOCK 


07H : 


BYTES 2 THROUGH 8 NOT USED 


> 


END OF 


SRB5 




5 

BUFFER 


BLOCK 


100H ; 


OUR I/O AREA 


CONI 


ASCII 


"CONI" ; 


ASCII OF "CONI" 




BYTE 


ODH ; 


+ <CR> 


LPT 


ASCII 


"LPT" ; 


ASCII OF "LPT" 




BYTE 


ODH ; 


+ <CR> 






END OF 


DATA DEFINITIONS 








BEGINNING OF EXECUTABLE CODE 




ORG 


1000H ; 


ENTRY POINT INTO PROGRAM 


START 


OUT 


(0F7H),A ; 


CALL SVC1 




NOP 




TO ASSIGN "CONI" 




LD 


A,(SRB1ST) ; 


CHECK THE STATUS TO SEE 




CP 


OOH 


IF ALL WENT WELL 




JP 


NZ, ABORT 


NO? STOP EVERYTHING 




OUT 


(0F6H),A 


YES? CALL SVC2 




NOP 




TO ASSIGN "LPT" 




LD 


A, (SRB2ST) 


CHECK THE STATUS TO SEE 




CP 


OOH 


; IF ALL WENT WELL 




JP 


NZ, ABORT 




LOOP 


OUT 


(0F5H),A 


; CALL SVC3 




NOP 




; TO READ A "CONI" LINE 




LD 


A., (SRB3ST) 


; INTO "BUFFER" 




CP 


OOH 


; ALL OK? 




JP 


NZ, ABORT 


, NO? STOP EVERYTHING 




OUT 


(0F4H),A 


, CALL SVC4 




NOP 




; TO WRITE TO "LPT" 




LD 


A, (SRB4ST) 


; CHECK TO SEE IF 




CP 


OOH 


; ALL IS OK 


> 


JP 


Z,LOOP 


; YES? BACK TO READ ANOTHER LINE 
NO? FALL THROUGH TO TERMINATION 


ABORT 


OUT 


(0F3H),A 


; CALL SVC5 




NOP 




; TO DO THE ABORT 




HALT 




; SHOULD NEVER REACH HERE 




END 


START 





Fig. 7C-2. Z80 SVC demonstration program listing (part 2 of 2). 
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Z80 SPECIAL CONSIDERATIONS 

The Z80 emulator behaves like the Z80 microprocessor, with the following exceptions 

• Interrupts are detected only when user code is being executed. 

• When TRAce is enabled, there is a maximum 153 ns delay on the lORQ signal. 

• During TRAce sequences, the emulator performs the auxiliary memory refresh operations between exe- 
cution of user code instructions. 

Z80A JUMPERS 



Z80A Emulator Board 

The Z80A Emulator board contains two jumpers, J1 and J3. Jumper J1 selects between 2 MHz and 4 MHz 
as the system clock speed for Emulation Mode 0. Jumper J3 is used to delete wait states in Emulation Mode 
1. 



Z80A Driver/Receiver Board 

The Z80A Driver/Receiver contains two jumpers, J1041 and J3051 . In Emulation Mode 1 , MREQ is unavail- 
able to the prototype when jumper J1041 is in the right-most position. When J1041 is in the left-most 
position, MREQ is available to the prototype whenever HOLDA is not asserted. 



When jumper J3051 is in the right-most position, data fetched from program memory (in Mode 1) does not 
appear at the probe tip. When jumper J3051 is in the left-most position, data from program memory is driven 
to the prototype. If jumper J3051 is in the left-most position, jumper J1041 must also be in the left-most 
position. 



NOTE 
With jumper J3051 in the left-most position, prototype bus contentions may occur. 

Both jumpers J1041 and J3051 are shipped in the right-most position. 
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Z80B JUMPERS 
Z80B Emulator Board 

The Z80B emulator board contains four jumpers: J3003, J1059, J1061, and J1081, 



Jumper J3003 selects a clock speed of either 4 MHz or 6 MHz for Emulation Mode 0. A clock speed of 
6 MHz must not be used with a 8002A system. J1059 is placed in the normal position when the Z80B 
processor is in interrupt modes 1 and 2 or mode single-byte vectors. 



J1059 is placed in the IM MULTI position when the processor is in interrupt Mode and there is a 
possibility of multi-byte instruction vectors. In this position, the interrupt data is gated in from the probe tip 
by the INTA line, which is asserted and disabled by the stack write associated with the interrupt or the next 
fetch. The INTA line is asserted during a maskable interrupt shortly after Ml and lOREQ are asserted by the 
emulator processor. In Emulation Mode 1, and with the stack pointer mapped to program memory, it is 
possible to get an additional short MEMREQ pulse at the probe tip during the first part of the stack write. 



J1061 controls the number of wait states. (The function selected with J1061 may interact with the function 
selected by J1082. See the discussion, "4 MHz and Below", later in this section.) J1061 has three positions: 

• The WAITS position selects no wait state and should be used only with 8540 and 8550 systems at 
4 MHz and below. 

• The 85XX position selects one wait state and should be used only with 8540 or 8550 systems. 

• The 800X position selects two wait states and should be used only with 8001 or 8002A systems. 



J1081 controls the modes of operation under which wait states are inserted. The positions required for 
various configurations of the systems are described in the following text. 



8001 /8002A Systems Jumper Considerations 

• When J1081 is in the SLOW position, J1061 shouid be in the 800X position and J30G3 should be in the 
4 MHz position. 

• Two wait states are inserted each time the program memory is accessed, or when running in emulation 
Mode 1. 

• No wait states are inserted in Mode 2 except when operating in debug mode, or memswitch mode during 
the jump sequence. Two wait states are inserted In these modes. 
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8500-Series Systems Jumper Considerations 

• 4 MHz and Below. With J1 081 placed in the SLOW position and J1 061 placed in the WAITS position, no 
wait states are inserted in Emulation Modes 0, 1 , or 2. One wait state is inserted during a forced jump 
sequence. 

• 4 MHz to 6 MHz. When operating between 4 and 6 MHz, the following wait states may be selected 
(J1061 in 85XX position). (If operating is Emulation Mode 1 and all memory is mapped to program 
memory, .J1061 can be placed in WAITS position with no wait states in Modes 0, 1, or 2.) 



NOTE 

You can generate additional wait states in Emulation Mode 1 or 2 when memory is mapped to the 
prototype. 



1. J1081 in SLOW Position (used with 670-6542-00 and up memory boards). 

a. One wait state inserted in Emulation Modes and 1. 

b. No wait states inserted in Emulation Mode 2 except during memswitch and forced jump operations 
when one wait state is inserted. 

2. J1081 in FAST Position (not used with 670-6542-00 and up memory boards). 

a. No wait states inserted in Emulation Modes and 2. 

b. One wait state is added during forced jump, memswitch operations, and Mode 1. 

Z80B Driver/Receiver Board 

The Z80B Driver/Receiver contains two jumpers: J1041 and J3051 . When memory is mapped to the system 
in Emulation Mode 1, MREQ is unavailable to the prototype when J1041 is in the right-most position. When 
J1041 is in the left-most position, MREQ is available to the prototype whenever HOLDA is not asserted. 



When jumper J3051 is in the right-most position, data fetched from program memory (Mode 1 only) does not 
appear at the probe tip. When J3051 is in the left-most position, data from program memory is driven to the 
prototype. If jumper J3051 is in the left-hand position, jumper J1041 must also be in the left-most position. 



NOTE 
With jumper J3051 in the left-most position, prototype bus contentions may occur. 

Both jumpers J1041 and J3051 are shipped in the right-most position. 
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Z80A EMULATOR TIMING 

In Emulation Modes 1 and 2, the emulating microprocessor resides in the Prototype Control Probe, and the 
signals between the prototype and the emulating microprocessor are buffered. Therefore, some timing 
differences exist between the Z80A emulator and a Z80A microprocessor that has been inserted directly into 
the prototype. Table 7C-4 lists these differences. Figure 7C-4 is a timing diagram corresponding to the 
signals present on the Z80A emulator. 
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Fig. 7C-3. Connecting the prototype clock input directly to the Prototype Control Probe. 

REDUCING DELAY THROUGH THE PROTOTYPE CONTROL PROBE 
(Z80B ONLY) 

The clock test point (on the Driver/Receiver board) can be used to obtain more accurate emulator timing 
under worst-case conditions above 4 MHz operation. In order to use the clock test point, you must discon- 
nect the prototype clock input pin from the prototype logic, and reconnect it directly to the clock test point in 
the Prototype Control Probe using a plug-on connector. 



The clock test point is located on the output of U1050 (pin 18 through a 68 fi resistor in series), and the 
output is within 10 ns of the actual CPU clock. When the prototype clock is connected directly to the clock 
source in the Prototype Control Probe, the 20 ns delay through probe circuitry is circumvented. Figure 7C-3 
illustrates the standard configuration and the adapted configuration for the prototype circuitry when imple- 
menting this clock test point user adaptation. 
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Table 7C-4 
Representative Z80A Emulator/Z80A Microprocessor Timing Differences 



Symbol 


Parameter 


Processor 
Min. Max. 


Emulator 
Min. Max. 


Units 












t{c) 


Clock period 


250 


250 


ns 


t{w(0H)) 


Clock pulse width, clock high 


110 ^ 


110 ^ 


ns 


t(w(0L)) 


Clock pulse width, clock low 


110 2000 


110 2000 


ns 


t(r,f) 


Clock rise and fall time 


30 


30 


ns 


t(D(AD)) 


Address output delay 


110 


130 


ns 


t(F(AD)) 


Delay to float 




85^^ 


ns 


t(D(D)) 


Data output delay 


150 


170 


ns 


t(F(F)) 


Delay to float during write cycle 


90 


110^ 


ns 


t(S0(D)) 


Data setup time to rising edge of clock 
during Ml cycle 


50 


70^ 


ns 


t(S(/){D)) 


Data setup time of falling edge of clock 
during M2 to M5 


60 


80* 


ns 


t(DL0(MR)) 


MREQ delay from falling edge of clock, 
MREQ low 


20 85 


359 1009 


ns 


t(DH0(MR)) 


MREQ delay from rising edge of clock, 
MREQ high 


85 


1009 


ns 


t(DH</){MR)) 


MREQ delay from falling edge of clock, 
MREQ high 


85 


1009 


ns 


t(DL<^(IR)) 


lORQ delay from hsing edge of clock, 
lORQ low 


75 


909 


ns 


t(DL0(IR)) 


lORQ delay from falling edge of clock, 
lORQ low 


85 


1009*^ 


ns 


t(DH0(IR)) 


lORQ delay from rising edge of clock, 
lORQ high 


85 


1009 


ns 


t(DH0(IR)) 


lORQ delay from falling edge of clock, 
lORQ high 


85 


1009 


ns 


t(DL<^(RD)) 


RD delay from rising edge of clock, 
RD low 


85 


959 


ns 


t(DL(^(RD)) 


RD delay from falling edge of clock , 
RD low 


95 


1059 


ns 


t(DH0(RD)) 


RD delay from rising edge of clock, 
RD high 


85 


959 


ns 


t(DH0(RD)) 


RD delay from falling edge of clock, 
RD high 


85 


959 


ns 


t(DL(/)(WR)) 


WR delay from rising edge of clock, 
WR low 


65 


759 


ns 
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Table 7C-4 (cont) 
Representative Z80A Emulator/Z80A Microprocessor Timing Differences 



Symbol 


Parameter 


Processor 
Min. Max. 


Emulator 
Min. Max. 


Units 


t(DL(A(WR)) 


WR delay from falling edge of clock, 
WR low 


80 


909 


ns 


t(DH0{WR)) 


WR delay from falling edge of clock, 
WR high 


80 


909 


ns 


t{DL(M1)) 


M1 delay from rising edge of clock, 
M1 low 


100 


1109 


ns 


t(DH{M1)) 


M1 delay from rising edge of clock, 
Ml high 


100 


1109 


ns 


t(DL(RF)) 


RFSH delay from rising edge of clock, 
RFSH low 


130 


1409 


ns 


t{DH(RF)) 


RFSH delay from rising edge of clock, 
RFSH high 


120 


1309 


ns 


t(S(WT)) 


WAIT setup time to falling edge of clock 


70 


90* 


ns 


t{D(HT)) 


HALT delay time from falling edge of clock 


300 


3159 


ns 


t(s(IT)) 


INT setup time to rising edge of clock 


80 


125' 


ns 


t(s(BQ)) 


BUSRQ setup time to rising edge of clock 


50 


85' 


ns 


t(DL(BA)) 


BUSAK delay from rising edge of clock, 
BUSAK low 


100 


1109 


ns 


t(DH(BA)) 


BUSAK delay from falling edge of clock, 
BUSAK high 


100 


1109 


ns 


t(s{RS)) 


RESET setup time to rising edge of clock 


60 


105* 


ns 


t(F(C)) 


Delay to/from float (MREQ, lORQ, 
RD, and WR) 


80 


1159 


ns 


t(mr) 


M1 stable prior to lORQ Interrupt Ack.) 




h.i 


ns 



%c) = t(w(0H)) + t(w(<^L)) + t(r) + t(f) 

''Although static by design, testing guarantees a t(w((^H)) of 200 ^s maximum. 

'^Clock delay from the prototype to emulator CPU is 20 ns maximum. 

''Delay measured from BUSAK asserted at CPU. 

^Data will go to an indeterminate state, but will not tri-state unless BUSREQ is asserted. 

'Timing reference is to CPU clock. To reference prototype clock, subtract propagation delay through 
driver/receiver buffers (10 ns maximum). 

^Timing reference to CPU clock. To reference prototype clock, add propagation delay through 
driver/receiver buffers (20 ns maximum.) 

^lORQ can be delayed to maximum of 153 ns during INTA cycles while the Debug TRA MODE is active. 

't(mr) = 2 * t(c) + t(w((/.H)) + t(f) -65 

CPU timing reference: Mostek Microcomputer Z80 Data Book; Mostek Corporation, (1978). 
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Z80B EMULATOR TIMING 

In Emulation Modes 1 and 2, the emulating microprocessor resides in the Prototype Control Probe, and the 
signals between the prototype and the emulating microprocessor are buffered. Therefore, some timing 
differences exist between the Z80B emulator and a Z80B microprocessor which has been inserted directly 
into the prototype. Table 7C-5 lists these differences. Figure 7C-4 is a timing diagram corresponding to the 
signals present on the Z80B emulator. 



Table 7C-5 
Representative Z80B Emulator/Z80B Microprocessor Timing Differences 



Symbol 


Parameter 


Processor 
Min. Max. 


Emulator 
Min. Max. 


Units 












t(c) 


Clock period 


165 


a 


165 


a 


ns 


t(w(0H)) 


Clock pulse width, clock high 


70 


b 


70 


b 


ns 


t(w{0L)) 


Clock pulse width, clock low 


70 


2000 


70 


2000 


ns 


t(r,f) 


Clock rise and fall time 


30 


c 


30 


ns 


t(D(AD)) 


Address output delay 


80 


100 


ns 


t(F(AD)) 


Delay to float 




SS"^ 


ns 


t(D(D)) 


Data output delay 


120 


140 


ns 


t(F{F)) 


Delay to float during write cycle 


60 


80^ 


ns 


t{S4>(D)) 


Data setup time to rising edge of clock 
during M1 cycle 


25 


4.5^ 


ns 


t(S(i)(D)) 


Data setup time to falling edge of clock 
during M2 to M5 


30 


5.0' 


ns 


t(DL0(MR)) 


MREQ delay from falling edge of clock, 
MREQ low 


20 


60 


359 


75g,h 


ns 


t{DH0(MR)) 


MREQ delay from rising edge of clock, 
MREQ high 


60 


759 


ns 


t(DH0{MR)) 


MREQ delay from falling edge of clock, 
MREQ high 


60 


759 


ns 


t(DL0(IR)) 


lORQ delay from rising edge of clock, 
lORQ low 


60 


759'^ 


ns 


t(DL0(IR)) 


lORQ delay from falling edge of clock, 
lORQ low 


60 


759 


ns 


t(DH0(IR)) 


lORQ delay from rising edge of clock, 
lORQ high 


60 


759 


ns 


+/nuA/io\\ 

HI./I iv^vii 1/; 


lORQ delay from falling edge of dock, 
lORQ high 


60 


759 


no 
1 t<f 


t{DU(RD)) 


RD delay from rising edge of clock, RD low 


60 


709 


ns 


t(DU(RD)) 


RD delay from falling edge of clock, RD low 


70 


809 


ns 
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Table 7C-5 (cont) 
Representative Z80B Emuiator/Z80B Microprocessor Timing Differences 



Symbol 


Parameter 


Processor 
Min. Max. 


Emulator 
Min. Max. 


Units 


t(DH(/>(RD)) 


RD delay from rising edge of clock, RD high 


60 


709 


ns 


t(DH0(RD)) 


RD delay from falling edge of clock, RD high 


70 


809 


ns 


t(DL0(WR)) 


WR delay from rising edge of clock, WR low 


60 


709 


ns 


t(DL<^(WR)) 


WR delay from falling edge of clock, WR low 


55 


659 


ns 


t(DH</>(WR)) 


WR delay from falling edge of clock, WR high 


55 


659 


ns 


t(DL(M1)) 


Ml delay from rising edge of clock, Ml low 


80 


909 


ns 


t(DH(M1)) 


M1 delay from rising edge of clock. Ml high 


80 


909 


ns 


t(DL(RF)) 


RFSH delay from rising edge of clock, 
RFSH low 


100 


1109 


ns 


t(DH(RF)) 


RFSH delay from rising edge of clock, 
RFSH high 


100 


1109 


ns 


t(S(WT)) 


WAIT setup time to falling edge of clock 


40 


60' 


ns 


t(D(HT)) 


HALT delay time from falling edge of clock 


200 


2159 


ns 


t(s(IT)) 


INT setup time to rising edge of clock 


45 


90' 


ns 


t(s(BQ)) 


BUSRQ setup time to rising edge of clock 


40 


75' 


ns 


t(DL(BA)) 


BUSAK delay from rising edge of clock, 
BUSAK low 


65 


759 


ns 


t(DH{BA)) 


BUSAK delay from falling edge of clock, 
BUSAK high 


55 


659 


ns 


t(s(RS)) 


RESET setup time to rising edge of clock 


45 


90' 


ns 


t(F(C)) 


Delay to/from float (MREQ, lORQ, RD, 
and WR) 


60 


959 


ns 


t{mr) 


M1 stable prior to iORQ (Interrupt Ack.) 


i 


i.j 


ns 



^t(c) = t(w{</.H)) + t(w(<^L)) + t(r) + t(f). 

''Although static by design, tesing guarantees a t(w{<^H)) of 200 ^s maximum. 

'^Clock delay from prototype to emulator CPU is 20 ns maximum. 

"^Delay measured from BUSAK asserted at CPU. 

^Data will go to an indeterminate state, but will not tri-state unless BUSREQ is asserted. 

'Timing reference is to CPU clock. To reference prototype clock, subtract propagation delay through 
Driver/Receiver Buffers (10 ns maximum). 

^Timing reference to CPU clock. To reference prototype clock, add propagation delay through Driver/Receiver 
Buffers (20 ns maximum). 

''Emulation Mode 1, on a memory change from system to prototype, MREQ or IORQ would be delayed up to 184 ns. 

4(mr) = 2 * t(c) + t(w(<^H)) + t(f) -50. 

'IORQ can be delayed a maximum of 153 ns during INTA cycles while the Debug TRA MODE is active. 
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Fig. 7C-4. Z80 microprocessor bus timing. 
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Z80A PROBE/PROTOTYPE INTERFACE DIAGRAM 

Figure 7C-5 is a block diagram of the interface between the prototype and the emulating microprocessor in 
the Prototype Control Probe. This figure provides a functional overview of emulator buffering. Signal buffers 
labeled with a generic chip type (i.e., LS244) represent single level buffering. Non-labeled blocks represent 
possible multi-level buffering. A more detailed circuit description can be found in the Z80 Emulator Processor 
Service Manual. 



Z80B PROBE/PROTOTYPE INTERFACE DIAGRAM 

Figure 7C-6 is a block diagram of the interface between the prototype and the emulating microprocessor in 
the Prototype Control Probe. This figure provides a functional overview of emulator buffering. Signal buffers 
labeled with a generic chip type (i.e., LS241) represent single level buffering. Non-labeled blocks represent 
possible multi-level buffering. A more detailed circuit description can be found in the Z80 Emulator Processor 
Service Manual. 
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Fig. 7C-5. Block diagram of Z80A emulator/prototype interface. 



REV AUG 1982 



7C-23 



Emulator Timing 



Z80 Emulator Specifics Users 



Z80B Microprocessor 
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Fig. 7C-6. Block diagram of Z80B emulator/prototype interface. 
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INSTALLING YOUR Z80 EMULATOR SOFTWARE 



8540 FIRMWARE INSTALLATION PROCEDURE 

The ROM devices that contain the control software for your Z80 emulator must be installed in your 8540's 
System ROM board. Refer to your Emulator Installation Manual for instructions on installing these ROM. 



8550 SOFTWARE INSTALLATION PROCEDURE 

Your emulator Installation software consists of two disks: 

• a disk that contains emulator control software, which you install onto your DOS/50 system disk so that 
DOS/50 can control your emulator hardware. 

• a disk that contains Z80 emulator diagnostic software. For a Z80A emulator, you must Install this disk 
onto your 8550 system diagnostic disk so that diagnostic tests can be run on your emulator as well as 
other 8550 system hardware. For a Z80B emulator, the diagnostic disk can be used directly. 

This subsection describes how to install the emulator control software for a Z80 emulator. 

To complete this installation procedure you need the following items: 

• an 8550 system (with or without a Z80 emulator); 

• a DOS/50 system disk with a write-enable tab over the write-protect slot; 

• a Z80 emulator software installation disk with no write-enable tab; and 

• (for installation of Z80A diagnostic software) an 8550 system diagnostic disk with a write-enable tab over 
the write-protect slot. 

This installation procedure takes about five minutes. 

Start Up and Set the Date 

Turn on your 8550 system. (For start-up instructions, refer to the Learning Guide of your 8550 System Users 
Manual.) Place your system disk in drive and shut the drive door. When you see the > prompt on your 
system terminal, place your installation disk in drive 1 and shut the drive 1 door. 



Use the DAT command to set the date and time. For example, if it is 1 1 :05 am on October 30, 1983, type: 

> DAT 30-0CT-83/ll:05 <CR> 



The system uses this information when it sets the CREATION time atthbute of each file copied from your 
installation disk. 
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Install the Emulator Control Software 

The command file INSTALL2, which installs the emulator control software, resides on the installation disk. 

NOTE 
If your system disk contains DOS/50 Version 1, use the command file INSTALL instead of INSTALL2. 



To execute the command file, simply type its filespec: 

> VOL/EMU. Z80/INSTALL2 <GR> 



DOS/50 responds with the following message: 

* During this installation procedure, one or more of the 

* following messages may appear. IGNORE THESE MESSAGES; 

* 

* Error 6E — ^Directory alteration invalid 

* Error 7E — Error in command execution 

* Error ID — File not found 

* If any OTHER error message appears, see your 

* Users Manual for further instructions. 

* If no other error message appears, you'll receive a 

* message when the installation procedure is complete. 

* 

T, OFF 



In this installation procedure, you may disregard error messages 6E, 7E, and ID; these messages have no 
bearing on the success of the installation. However, if a message other than 6E, 7E, or 1 D appears, take the 
following steps: 

1 . Make sure you are using the right disks. 

2. Make sure your system disk has a write-enable tab. 

3. Make sure there are at least three files and 20 free blocks on your system disk. 

4. Begin the installation procedure again. 



If the installation procedure fails again, copy down the error message and contact your Tektronix service 
representative. 



The T, OFF command suppresses subsequent output to your system terminal (except error messages) until 
INSTALL2 finishes executing. Within about five minutes, INSTALL2 will finish and your system terminal will 

display the following message: 

* 

* Your installation has been successfully completed. 
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Install the Emulator Diagnostic Software 

If you are using a Z80A emulator, you can now install the emulator diagnostic software. If you are using a 
Z80B emulator, you can use the emulator diagnostic software disk as provided. 



Note the Name of Your Diagnostic Disk. In order to install the emulator diagnostic software, you must 
know the name of your 8550 system diagnostic disk. Remove your emulator installation disk from drive 1 
and insert the diagnostic disk. Enter the following command to list the names of the two disks mounted in 
your 8550: 

> ATT /VOL/* WHERE <CR> 

sysvol WHERE=FLXO-< DOS/50 system disk 

8550DIAGX.X WHERE=FLXi -« 8550 system diagnostic disk 



Note the name of your diagnostic disk. (It should be something like 8550DIAG2.0.) 



Insert Your Emulator Installation Disk into Drive 1. INSTALLDIAGS, the command file that installs the 
diagnostics, resides on the installation disk. Remove your diagnostic disk from drive 1 and insert your 
installation disk. Invoke the INSTALLDIAGS command file and pass it the name of your diagnostic disk, 
which you just noted: 

> /VOL/EMU. Z80/INSTALLDIAGS 8550DIAGx.x <CR> 



DOS/50 responds with the following messages: 

DIAGNOSTIC INSTALLATION PROCEDURE 

+ 

* During this installation procedure, the following error 

* message will appear once. IGNORE THIS MESSAGE: 

* Error 2A Parameter required 

* If any OTHER error message appears or this appears more 

* than once, see your Users Manual for further instructions. 

* If no other error message appears, you'll receive a message 

* when the installation is complete. 

T.OFF 

COP; Error 2A Parameter required 



Remove the DOS/50 System Disc 
Insert the 8550 System Diagnostic Disc 
Type CO -A 



SUSP, -A 
» 
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Insert Your Diagnostic Disk into Drive 0. Remove your 8550 system disk from drive and insert your 8550 
system diagnostic disk. Then enter the command CO -A to continue execution of the command file: 

> CO ^ <CR> 



After a few minutes, the following message is displayed: 

COP, -BN,/V0L/EMU.Z80/DIAGS/Z80.TST,/V0L/8550DIAGx.x/Z80.TST 

* — *► Remove 8550 System Diagnostic Disc 



■*- Insert DOS/50 System Disc 
-^ Press CTRL-C 
-*- Type CO -A 



SUSP, -A 



Insert Your DOS/50 System Disk Into Drive 0. Remove your diagnostic disk from drive and insert your 
DOS/50 system disk. Then enter the CO -A command again: 

> CO ^ <CR> 



The command file finishes with the following message: 

USER, , NO. NAME 

DIAGNOSTIC INSTALLATION COMPLETE 



In this installation procedure, error message 2A should appear once. If any other error message appears, 
check your disks and begin the diagnostic installation procedure again. If the installation procedure fails 
again, copy down the error message and contact your Tektronix service representative. 



Once your software is installed, you can: 

• remove your disks and turn off your 8550 system, or 

• install more software, or 

• continue with the Z80 Emulator Demonstration Run that follows in this section. If you do this, you do not 
have to restart the system or reset the date and time. 



NOTE 

At this point NO. NAME is the current user. To change the current user back to yourname, enter 
USER,,yourname. 
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Z80 Demonstration Run 



Z80 DEMONSTRATION RUN 



the P command. This demonstration shows 
how. 



INTRODUCTION 

This demonstration run shows you how to 
load, execute, and monitor a simple Z80 as- 
sembly language program on your 8540 or 
8550. In order to perform this demonstration, 
your Z80 emulator hardware and control 
software must be installed in your 8540 or 
8550. 



Figure 7C-8 shows the source and object 
code for the demonstration program. 



If you have an 8550 (as in Fig. 7C-7, Case 1), 
the source code and object code for the dem- 
onstration program are provided on the in- 
stallation disk that contains your Z80 
emulator control software. This demonstra- 
tion shows you how to assemble the pro- 
gram on your 8550. (If your system disk does 
not contain a Z80 assembler, you will have to 
skip that part of the demonstration.) 



If you have an 8540/8560 system (See Fig. 
7C-7, Case 2), and your 8560 has a Z80 as- 
sembler installed, you can create and assem- 
ble the program on the 8560 and then 
download it to the 8540. This demonstration 
shows how. 



If you have an 8540 (Fig. 7C-7, Case 3) that 
is connected to a host computer other than 
an 8560, we can't give you a specific list of 
commands for creating and assembling the 
program on your host (since we don't know 
what host you're using). However, Fig. 7C-9 
gives the object code for the program in Ex- 
tended Tekhex format. You can create the 
Tekhex file using your host's assembler or 
text editor, and then download the file to the 
8540 via the 8540's optional COM interface. 

If none of these cases applies to you, you 
can patch the program into memory by using 



Once the program is loaded or patched into 
memory, you can execute the program on 
your emulator. 



Case 1 : 




8540 + 8560 




Case 3: 




8540 + other host 



Case 4: any other configuration 



3964 5A 



Fig. 70-7. System configurations. 
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NOTE 

The 8540 commands shown in this demonstration can also be used for an 8550 that is connected to 
an 8560 or other host computer 



01 






;Z80 


DEMONSTRATION RUN PROGRAM 


02 








SECTION DEMO 




05 








ORG 


100H 


START PROGRAM CODE AT ADDRESS 100 


04 


000100 


210005 


START 


LD 


HL, TABLE 


SET TABLE POINTER 


05 


000103 


0605 




LD 


B, TSIZE 


SET PASS COUNTER 


05 


000105 


AF 




XOR 


A 


CLEAR ACCUMULATOR 


07 


000106 


86 


LOOP 


ADD 


A,(HL) 


ADD BYTE FROM TABLE 


08 


000107 


23 




INC 


HL 


POINT TO NEXT BYTE 


09 


000108 


05 




DEC 


B 


DECREMENT PASS COUNTER 


10 


000109 


C20601 




JP 


NZ,L00P 


LOOP IF NOT FIVE PASSES YET 


1 1 


0001 oc 


D3F7 




OUT 


(0F7H),A 


OTHERWISE CALL EXIT SVC 


12 


0001 OE 


00 




NOP 




TO END PROGRAM EXECUTION 


V) 






;SRB 


POINTER 




14 








ORG 


40H 


STORE SRB POINTER AT ADDRESS 40 


15 


000040 


000042 




BYTE 


00,42H 


;P0INT TO SRB FOR EXIT SVC 


1 6 






;SRB 


FOR EXIT SVC 




17 


000042 


1A 




BYTE 


1 AH 


;1AH = FUNCTION CODE FOR EXIT SVC 


18 






; TABLE OF NUMBERS TO BE ADDED 


19 






TSIZE 


EQU 


5 


;TABLE SIZE = 5 


20 








ORG 


500H 


;SET UP TABLE AT ADDRESS 500 


21 






TABLE 


BLOCK TSIZE 




22 








LIST 


DBG 




23 








END 


START 




= = 


====== 






1 




1 








1 
source code 


1 
comments 






+ — 


obj ect 


code 






+ _ 


+ -- 




address 


code 1 


ine number 










source 





Fig. 7C-8. Demonstration program. 
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(A) 

^27692 ':$1 0021 00050605AF862305C 20601 D3F700 
^0E62B24000421A 

^3A3494DEM0O1O55O514LO0P31O6l5START31OO15TABLE35OO25TSIZEl5 
^0981 53100 

(B) 

FIRST DATA BLOCK: object code for addresses 100--10E 

header 

I load address object code 
I I I 

I I I 

^27692 31 0021 00050605AF862305C 20601 D3F700 

SECOND DATA BLOCK: object code for addresses 40--42 

header 

I load object 

I address code 
I I I 
I I I 

?oOE62B24000421A 

SYMBOL BLOCK 

header section 

I section definition 

I name field symbol definition fields 

III I 

III I 

:^3A3494DEM0O1035O514L00P31O61 5S TART 5 1001 5TABLE350025TSIZE1 5 

TERMINATION BLOCK 

header' 

i transfer 

I address 
I I 

I I 

5b0981 53100 



Fig. 7C-9. Demonstration program: Extended Tekhex format. 
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Figure 7C-9A shows an Extended Tekhex load module that contains the object code and program symbols 
for the demonstration program. Figure 7C-9B labels the different fields in the message blocks. If you have a 
host computer other than an 8560, you can create this load module and download it to your 8540 or 8550. 



EXAMINE THE DEMONSTRATION PROGRAM 

The demonstration program adds five numbers from a table stored in locations 500 to 504 in program 
memory and leaves the sum in register A. (You will place values in the table later in this demonstration.) The 
8085A emulator demonstration run in the Learning Guide of your System Users Manual contains a flowchart 
that illustrates the steps of the Pi'ogram. 



The source code contains two kinds of statements: assembler directives (such as ORG and BYTE) and Z80 
assembly language instructions. The assembler directives are microprocessor-independent and are ex- 
plained in the 8085A emulator demonstration run. The Z80 assembly language instructions are discussed in 
the following paragraphs. 



Set Table Pointer. The LD HL, TABLE instruction loads the address of the table (500) into the H-L register 
pair. As a result, the H-L pair points to the first element of the table. The lable START is used by the END di- 
rective to specify that the LD HL, TABLE instruction is the first to be executed. 



Set Pass Counter. Register B is used as the pass counter. The LD B, TSIZE instruction loads the value 5 
into register B. This step sets the number of passes to 5. 



Clear Accumulator. The XOR A instruction zeros the accumulator (register A) so you can start adding 
numbers from the table. 



Add Byte from Table. The ADD A, (HL) instruction adds the byte addressed by the H-L register pair into the 
accumulator. The label LOOP represents the address of this instruction; this label is used by the JP NZ 
instruction. 

Point to Next Byte. The INC HL instruction increments the address contained by the H-L register pair; the H- 
L register pair then points to the next byte in the table. For example, the H-L register pair is initialized to 
contain 500. After the INC HL instruction is first executed, the H-L register pair will contain 501 , the address 

of the second byte in the table. 

Decrement Pass Counter. The DEC B instruction decrements register B, the pass counter. In this program, 
B is decremented each time a number is added to the accumulator. 

Loop If Not Five Passes Yet. The JP NZ, LOOP instruction checks the contents of register B and jumps to 
the LOOP label if B does not contain zero. If B contains zero, the program proceeds to the next instruction, 
OUT (0F7H),A. 

Exit. The OUT (0F7H),A and NOP instructions constitute a service call (SVC) that causes an exit from the 
program. For more information on SVCs, refer to the Service Calls section of your System Users Manual. 
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ASSEMBLE AND LOAD THE DEMONSTRATION PROGRAM 

Now it's time to create the program so you can run it on your emulator. One of the following discussions 
describes the set of steps that is appropriate for your hardware configuration: 

• For 8550 users — Case 1 : Assemble and Load on the 8550 

• For 8540/8560 users— Case 2: Assemble on the 8560; Download to the 8540 

• For 8540 users with a host computer other than the 8560 — Case 3: Download from Your Host to the 
8540 

• For other hardware configurations — Case 4: Patch the Program into Memory 



Go ahead and work through the discussion that's appropriate for you. Once you've put the program into 
program memory, turn to the heading Run the Demonstration Program, later in this section. 



CASE 1: ASSEMBLE AND LOAD ON THE 8550 

This discussion shown you how to copy the demonstration program from your Z80 emulator software 
installation disk, assemble the program, and load it into 8550 program memory. 



Start Up and Log On 

Turn on your 8550 system. (For start-up instructions, refer to the paragraph Start Up the 8550 and Its 
Peripherals in the Learning Guide of your System Users Manual.) Place your system disk in drive and shut 
the drive door. When your system displays the > prompt, place your Z80 emulator software installation 
disk in drive 1 and shut the drive 1 door. 



Use the DAT command to set the current date and time. For example, if it is 2:30 pm on October 31 , 1981 , 
enter the following command line: 

> DAT 51-0CT-81/2!50 PM <CR> 

Use the SEL command to tell DOS/50 to use the assembler and emulator software designed for the Z80: 

> SEL Z80 <CR> 

The SEL command automatically sets the emulation mode to 0. 

Copy the Demonstration Run Program from the Installation Disk 

Enter the following command lines to create an empty directory called DEMO on your system disk and make 
DEMO the current directory. The BR command creates a brief name, ROOT, to mark the old current 
directory. At the end of this demonstration, you will return to this ROOT directory and delete the DEMO 
directory and its contents. 

> BR ROOT/USR <CR> 

> CREATE DEMO <CR> 

> USER DEMO <CR> 
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Now use the COP command to copy all the files in the DEM02 directory on the installation disk to the DEMO 
directory you just created: 

> COP /VOL/EMU. Z80/DEM02/'' * <CR> 



Remove your installation disk from drive 1 and put it away. 



Now list the files you have just copied to the current directory: 

> ^ <CR> 
FILENAME 



LOAD 




Files used 


124 


Free files 


132 


Free blocks 


821 


Bad blocks 






The file named ASM contains the assembly language source code for this demonstration program, and the 
file named LOAD contains the executable object code. This copy of LOAD will be used in the demonstration 
only if you do not have a Z80 assembler (and thus cannot create your own object file and load file from the 
source file.) 



Examine the Demonstration Program 

Enter the following command line to display the source file ASM on the system terminal: 

> CON ASM <CR> 

;Z80 DEMONSTRATION RUN PROGRAM 
SECTION DEMO 
lOOH 

HL, TABLE 
B.TSIZE 
A 

HL) 



START 



LOOP 



ORG 

LD 

LD 

XOR 

ADD 

INC 

DEC 

JP 

OUT 

NOP 

;SRB POINTER 
ORG 
BYTE 

;SRB FOR EXIT 
BYTE 



A,( 
HL 



NZ.LOOP 
{0F7H) J 



40H 

00,42H 
SVC 
lAH 



; TABLE OF NUMBERS TO 



TSIZE EQU 
ORG 

TABLE BLOCK 
LIST 
END 



5 

500H 

TSIZE 

DBG 

START 



START PROGRAM CODE AT ADDRESS 100 

SET TABLE POINTER 

SET PASS COUNTER 

CLEAR ACCUMULATOR 

ADD BYTE FROM TABLE 

POINT TO NEXT BYTE 

DECREMENT PASS COUNTER 

LOOP IF NOT FIVE PASSES YET 

OTHERWISE CALL EXIT SVC 

TO END PROGRAM EXECUTION 

; STORE SRB POINTER AT ADDRESS 40 
JPOINT TO SRB FOR EXIT SVC 



;1AH = FUNCTION CODE FOR EXIT SVC 
BE ADDED 

;TABLE SIZE = 5 

;SET UP TABLE AT ADDRESS 500 
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Assemble the Source Code 

If you do not have a Z80 assembler on your system disk, you cannot perform this step, so skip the next four 
commands (ASM, COP, LINK, and L). 



The ASM (AsSeMbie) command translates assembly language (source code) into binary machine language 
(object code). The ASM command also creates an assembler listing that can be used to correlate the object 
code with the source code. Enter the following command line to assemble the source code in the file ASM 
and create the listing the object files ASML and OBJ: 

> ASM OBJ ASML ASM <CR> 



I 

' source file 



assembler listing file 
object file 



Tektronix Z80 ASM Vx.x 
**** Pass 2 

23 Source Lines 23 Assembled Lines xxxxx Bytes Available 
>» No assembly errors detected <« 



Make sure your line printer is turned on and properly connected, then enter the following command to copy 
the assembler listing onto the printer: 

> COP ASML LPT <CR> 



Refer to Fig. 70-8 for an explanation of the different fields in your assembler listing. For a more detailed 
explanation, consult your Assembler Users Manual. 



Link the Object Code. The linker creates an executable load file from one or more object files. Enter the 
LINK command to invoke the linker: 

> LINK <CR> 
8550 LINKER Vx.x 



Now enter the following linker commands to create a load file called LOAD from your object file, OBJ: 

* LINK OBJ <CR> 
* LOAD LOAD <CR> 
*DEBUG <CR> 



■END <CR> 



The linker commands LINK and LOAD specify the object file and load file, respectively. The DEBUG com- 
mand causes the linker to pass the program symbols from the object file to the load file, for use in program 

Hohiinninn Aftt^r v/ni i twnp tho FMD rnmmanrl thp linkpr pypri itp<; thp nnmmanHQ uoii hav/p pntprpri pnrl thp 
^■^■""33" ■» "^^ J — - '7 1 — • — — "— — — • — > -■ J — ' — — 

following information is displayed: 

NO ERRORS NO UNDEFINED SYMBOLS 
1 MODULE 1 SECTIONS 
TRANSFER ADDRESS IS 0100 
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The files generated by the ASM and LINK commands should now be on your disk. Enter the following 
command to list the files in your current directory: 

> L <CR> 



TTTT ■C'\l f,MTp 



ASM 




LOAD 




OBJ 




ASML 




Files used 


126 


Free files 


130 


Free blocks 


811 


Bad blocks 






Notice that there are now four files listed in your directory. OBJ and ASML were created by the assembler, 
and LOAD was created by the linker. 



Load the Program into Memory 

Now it's time to load the object code from the load file LOAD into program memory. Once you've loaded the 
object code, you execute the program. 



Zero Out Memory. Before you load any code, use the F (Fill) command to fill program memory with zeros. 
Later, when you examine memory, the zeros make it easy to identify the beginning and end of your code. 
(Zeroing out memory has no affect on how the program is loaded.) Enter the following command line to fill 
memory addresses 40 to 1 1 F with zeros: 

> F 4':^ IIF 00 <CR> 



Check That Memory Was Filled with Zeros. Check the contents of memory with the D (Dump) command. 
The D command's display shows the data (in hexadecimal format) and also shows the corresponding ASCII 
characters. Display the contents of memory addresses 40 to 11F with the following command line: 

> D 40 IIF <CR> 

0123456789ABCDEF 

000040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 GO GO 

000050 GO 00 00 GO GO 00 00 00 GO GO GO GO GO GO 00 GO 

000060 00 GO 00 00 GO GO GO GO GO GO GO GO GO 00 GG GO 

000070 00 GO GO GO 00 00 GO 00 GO 00 GO GG 00 GO GO GG 

000080 00 GO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000090 00 00 00 GO 00 GO GO 00 GO 00 00 GG GO 00 GG 00 

OOGOAO 00 GO GO GO 00 GO 00 00 GO GO GO GG 00 GO GO GG 

GOOOBO 00 GO 00 00 GO 00 GO GO GO GO 00 GO GO 00 00 GO 

OOOOCO GO 00 00 GO GO 00 GO GO 00 00 00 GO GO 00 00 GG 

OOOOEO GO 00 GO 00 GO GO 00 GO 00 00 00 GO 00 GO 00 GO 

OOOOFO 00 00 GO 00 00 GO GO GO GO GG GO 00 00 GO GO GO 

000100 00 00 00 00 GO 00 00 GO 00 GO GO GO 00 00 GO 00 

000100 00 00 00 00 GO GO 00 00 00 00 00 00 GO GO GO 00 
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Load the Object Code into IVIemory. Enter the following command line to load the object code for the 
demonstration program into program memory: 

> LP <LOAD <CR> 
____ 

load file 



Load the Program Symbols. The source code for the demonstration program contained the directive LIST 
DBG. Because of this directive, the object file contains a list of the symbols that appeared in the source 
code, and the values associated with those symbols. Because you included the DEBUG command when you 
invoked the linker, those symbols were passed to the load file. Use the SYMLO command to load those 
symbols into the symbol table in 8550 system memory. 

> SYMLO -S <LOAD <CR> 



The -S option means that both addresses and scalars are loaded. If you omit the -S, only addresses are 
loaded. (A scalar is a number that is not an address — for example, TSIZE, the length of the table.) 



Later in this demonstration, whenever you use a symbol in a command line, DOS/50 refers to the symbol 
table to find the value that the symbol represents. 



You've assembled and linked the demonstration program and loaded it into memory. Now skip ahead to the 
heading Run the Demonstration Program. 



CASE 2: ASSEMBLE ON THE 8560; DOWNLOAD TO THE 8540 

This discussion shows you how to create the demonstration program source code and assemble it on the 
8560, then download it to 8540 (or 8550) program memory. If your 8560 does not have a Z80 assembler, 
you cannot complete this part of the demonstration, so skip ahead to the heading CASE 4: Patch the 
Program into Memory. 

Start Up and Log In 

Start up your 8540, make sure it's in TERM mode, and log in to the 8560 operating system, TNIX. See your 
8560 System Users Manual for details. 

Since you're logged in to TNIX, your system prompt is $. (Later in the demonstration, we'll show the system 
prompt as >, in deference to people using 8540s and 8550s in LOCAL mode.) Every command you enter is 
processed by TNIX. If you enter an OS/40 command, TNIX passes it to the 8540. 

Enter the following commands to select the Z80 assembler on the 8560 and the Z80 emulator on the 8540: 

$ uF =z80; export UP <CR > 
$ sel Z80 <CR > 

The sel command automatically sets the emulation mode to 0. 
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Create the Demonstration Program 

Enter the following TNIX command lines to create an empty directory called demo and make demo the 
working directory. You'll create your source file and related files in this demo directory. 

$ mkdir demo <CR> 
$ cd demo <CR> 



Now use the TNIX editor ed, to create the demonstration program source file. The following command line 
invokes the editor and specifies that you want to create a file called asm: 

$ ed asm <CR> 
?asin 



The editor responds ?asm to remind you that asm does not already exist. Notice that the editor does not 
give a prompt to let you know that it's ready for input. 



Enter the Text. Now enter the editor command a (append text) and type in the program. Use the BACK- 
SPACE key to erase any typing mistakes. 

_a <CR> 

column column column 
8 6 24 

i i i 

;Z80 DEMONSTRATION RUN PROGRAM <CR> 



SECTION DEMO <CR> 



ORG 



lOOH 



START LD 



HL, TABLE 



liU 



B.TSIZE 



XOR 



LOOP 



ADD 



A, (HL) 



INC 



HL 



DEC 



JP 



NZ.LOOP 



OUT 



(0F7H) ,A 



NOP 



START PROGRAM CODE AT ADDRESS 100 <CR> 



SET TABLE POINTER <CR> 



SET PASS COUNTER <CR> 



CLEAR ACCUMULATOR <CR> 



ADD BYTE FROM TABLE <CR> 



POINT TO NEXT BYTE <GR> 



DECREMENT PASS COUNTER <CR> 



LOOP IF NOT FIVE PASSES YET <CR> 



OTHERWISE CALL EXIT SVC <CR> 



TO END PROGRAM EXECUTION <CR> 



;SRB POINTER <CR> 
ORG 40H 



; STORE SRB POINTER AT ADDRESS 40 <CR> 



BYTE 00.42H 


; POINT TO SRB FOR EXIT SVC <CR> 


;SRB FOR EXIT SVC <CR> 
BYTE lAH 


;1AH = FUNCTION CODE FOR EXIT SVC 


; TABLE OF NUMBERS TO BE 
TSIZE EQU 5 


ADDED <CR> 

; TABLE SIZE =5 <CR> 


ORG 500H 


;SET UP TABLE AT ADDRESS 500 <CR> 



TABLE BLOCK TSIZE <CR> 



LIST 



END 



DBG v.CR> 



START <CR> 



<:CR.> 



At the end of your text, enter a period on a line by itself. The editor will now accept new commands. 
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Check for Errors. Type the following editor command to display the text you have entered. Check for typing 
mistakes. 

l,$p <CR> 

' print command: displays the lines 

in the designated range 



-designates last line in file 
-designates first line in file 



If you made any mistakes, fix them now. In case you're not familiar with the editor, Table 7C-6 lists the 
commands you need in order to add, delete, or replace a line. For more information on the TNIX editor, refer 
to your 8560 System Users Manual. 



Table 7C-6 
Basic 8560 Editing Commands 



Command 


Function 


mm,nnp<CR> 


Displays lines mm through nn 


nn<CR> 


Makes line nn the current line 


d<CR> 


Deletes the current line 


a<CR> 

<line{s) of text> 
.<CR> 


Adds text below the current line 


c<CR> 

<line(s) of text> 
.<CR> 


Replaces the current line with the text 
you type in 



Once your text is correct, enter the w command to write the text to the source file, asm: 

jw_ <CR> 
902 



The editor responds with the number of characters written to the file. 



Finally, enter the q command to quit the editor and return to TNIX: 

_q_<CR> 

hP ^^ I l'«l#x pivriiipi 
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Assemble the Source Code. 

The TNIX asm (asseniD\e) command translates assembly language (source code) into binary machine lan- 
guage (object code). The asm command also creates an assembler listing that you can use to correlate the 
object code with the source code. Enter the following command line to assemble the source code in the file 
asm and create the listing and object files asmi and obj: 

$ asm obJ asml asm <CR> 

I ♦ f 
I 
I source file 



assembler listing file 
object file 



Tektronix ASM Z80 
Vxx.xx-xx (8560) 
*****Pass 2 

23 Lines Read 

23 Lines Processed 

Errors 



Enter the following command to print the assembler listing on the 8560's line printer: 

$ Iplr asml <CR> 



Examine page 1 of your listing. Did the assembler issue any error messages? There should be none. If your 
source code contains errors, take the following steps. 

1 . Refer to your Assembler Users Manual to find out what the error messages mean. 

2. Enter the command ed asm to get back into the editor and fix the mistakes in your source code. Exit the 
editor with the w and q commands, as before. 

3. Enter the command asm obj asml asm to re-assemble your source code. 



Link the Object Code 

The linker creates an executable load file from one or more object files. Enter the following command to 
create a load file called load from your object file, obj. Be sure to enter all parameters exactly as shown. 

$ link -d -0 obj -o load <CR> 



The -d option causes the linker to pass the program symbols from the object file to the load file, for use in 
program debugging. 



The files generated by the asm and link commands should now be in your working directory, demo. Enter the 
following command to list the files in your working directory: 

$ 2s <GR> 
asm 
asml 
load 

obj 
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Notice that there are now four files listed in your directory: obj and asmi were created by the assembler, and 
load was created by the linker. 



Download the Program to the 8540 

Now it's time to download the object code produced by the 8560's linker into 8540 program memory. 



Zero Out Memory. Before you download any code, use the OS/40 F (Fill) command to fill 8540 program 
memory with zeros. Later, when you examine memory, the zeros make it easy to identify the beginning and 
end of your code. (Zeroing out memory has no effect on how the program is loaded.) Enter the following 
command line to fill memory addresses 40 to 11F with zeros: 

$ f 40 llf 00 <CR> 



Check That Memory Was Filled with Zeros. Check the contents of memory with the OS/40 D (dump) 

command. The D command's display shows the data in hexadecimal format, and also shows the corre- 
sponding ASCII characters. Display the contents of memory addresses 40 to 11F with the following com- 
mand line: 

$ d 40 llf <CR> 

0123456789ABCDEF 

000040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000050 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000070 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000090 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOAO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOBO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOCO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOODO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOEO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOFO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000110 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 



Download the Object Code. Enter the following command line to download the object code from the 8560 
file load to 8540 program memory: 

$ lo <load <LCR> 
= = = = 

I 

load file 

Download the Program Symbols. The source code for the demonstration program contains the directive 
LIST DBG. Because of this directive, the object file contains a list of the symbols that appear in the source 
code and the values associated with those symbols. Because you included the -d option in the link com- 
mand line, those symbols were passed to the load file. Use the OS/40 SYMLO command to download those 
symbols into the symbol table in 8540 system memory. 

$ symlo -s <load <CR> 



The -s option means that both addresses and scalars are downloaded. If you omit the -8, only addresses 
are downloaded. (A scalar is a number that is not an address — for example, TSIZE, the length of the table.) 
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Later in this demonstration, whenever you use a symbol in an OS/40 command line, OS/40 refers to the 
symbol table to find the value that the symbol represents. 



You've assembled and linked the demonstration program and downloaded it into memory. Now skip ahead 
to the heading Run the Demonstraion Program. 



CASE 3: DOWNLOAD FROM YOUR HOST TO THE 8540 

This discussion gives some general instructions for downloading the demonstration program from a host 
computer other than the 8550 or 8560 to 8540 (or 8550) program memory. If your 8540 is not equipped with 
the optional COM Interface Package, you cannot complete this part of the demonstration, so skip ahead to 
the heading Case 4: Patch the Program into Memory for instructions. COM Interface software is standard 
on the 8550. 



Since we don't know what host computer you're using, we can only provide a general outline for creating the 
demonstration program and downloading it to the 8540. Once you have determined the command sequence 
that is appropriate for your host, record this information in the space provided in Fig. 7C-10. 



Create the Extended Tekhex Load Module 

In order for object code to be downloaded to the 8540, it must be in Extended Tekhex format, as shown in 
Fig. 7C-9. You can create the load module in one of two ways: 

1 . using your host computer's text editor, key the load module in by hand; or 

2. using your host computer's Z80 assembler to 

a. translate the demonstration program into the language of your host's Z80 assembler; 

b. create and assemble the source file; 

c. link the object code, if necessary; and 

d. translate the object code produced by the assembler or linker into Extended Tekhex format. The 
Intersystem Communication section of your System Users Manual provides a general algorithm for 
conversion to Extended Tekhex format. 

Prepare the 8540 

Start up your 8540 and enter the following command to select the Z80 emulator: 

> SEL Z80 <CR> 

The SEL command automatically sets the emulation mode to 0. 
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Create the Extended Tekhex 


Load 


Module 


Prepare the 8540 






(start up the 8540. ) 






> SEL Z80 <CR> 






> F 40 1 1F 00 <CR> 






> D 40 1 1F <CR> 






Establish CommurLication 






Download the Load Module 






Terminate Communication 







Fig. 7C-10. Host computer commands for preparing demonstration program. 



Zero Out IVIemory. Before you download any code, use the OS/40 F (Fill) command to fill 8540 program 
memory with zeros. Later, when you examine memory, the zeros make it easy to identify the beginning and 
end of your code. (Zeroing out memory has no affect on how the program is loaded.) Enter the following 
command line to fill memory addresses 40-11 F with zeros: 

> F 40 IIF 00 <CR> 
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Check That Memory Was Filled with Zeros. Check the contents of memory with the OS/40 D (Dump) 
command. The D command's display shows the data (in hexadecimal format) and the corresponding ASCII 

characters. Display the contents of memory addresses 40 to 11 F with the following command line: 

> D 40 IIF <CR> 

0123456789ABCDEF 

000040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000050 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000070 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000090 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOAO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOBO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOCO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOODO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOEO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOFO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000110 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 



Download the Load Module to the 8540 

Be sure that your 8540 and your host computer are connected via an RS-232-C compatible communication 
link. Refer to the Intersystem Communication section of your System Users Manual to determine the com- 
mands and parameters that are appropriate for your host computer. Then perform the following steps to 
download the Tekhex load module to 8540 program memory. 

1 . Enter the 8540 COM command to establish communication. (The parameters of the COM command are 
host-specific.) Log on to your host and execute any necessary host initialization commands. 

2. Enter the command line that downloads the Tekhex load module to the 8540. This command line consists 
of the host computer command that performs the download, followed by a null character (CTRL-(a) on 
most terminals) and a carriage return. COM places the object code in 8540 program memory, and puts 
the program symbols into the symbol table in 8540 system memory. 

3. Log off from your host, and then terminate COM command execution by entering the null character, then 
pressing the ESC key. 

Once you've downloaded the program to the 8540, skip ahead to the heading Run the Demonstration 
Program. 



CASE 4: PATCH THE PROGRAM INTO MEMORY 

This discussion shows you how to patch the demonstration program into 8540 (or 8550) program memory 
using the P command, and then add the program symbols into the symbol table using the ADDS command. 



Ordinarily, you would load the object code and symbols from a binary or hexadecimal load file, as illustrated 
for Cases 1, 2, and 3. The procedure presented here is not normally used for preparing a program for 
execution. Use this procedure only if you have no standard means for preparing the program, but would still 
like to try out your emulator. 
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Start Up the 8540 

Start up your 8540 and enter the following command to select the Z80 emulator: 

> SEL Z80 <CR> 



The SEL command automatically sets the emulation mode to 0. 



Zero Out Memory 

Before you patch in any code, use the OS/40 F (Fill) command to fill 8540 program memory with zeros. 
Later, when you examine memory, the zeros make it easy to identify the beginning and end of your code. 
Enter the following command line to fill memory from addresses 40 to 1 1F with zeros: 

> F 40 IIF 00 <CR> 



Check That Memory Was Filled with Zeros. Check the contents of memory with the OS/40 D (Dump) 
command. The D command's display shows the data (in hexadecimal format) and the corresponding ASCII 

characters. Display the contents of memory addresses 40 to 11 F with the following command line: 

> D 40 IIF <CR> 

0123456789ABCDEF 

000040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000050 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000070 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000090 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOAO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOBO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOCO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOODO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOEO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOFO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000110 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 



Patch the Object Code into Memory 

The OS/40 P (Patch) command stores a sequence of bytes into memory, replacing the previous memory 
contents. Enter the following command to store the object code for the first three instructions in the program 
(LD HL, LD B, and XOR A) starting at location 100: 

> P 100 210005 0605 AF <CR> 



4 ♦ ♦ I 

XOR A 
LD B,TSIZE 
LD HL.TABLE 
patch address 

Now patch in the next four instructions (ADD A, INC HL, DEC B, and JP NZ,LOOP)... 

> P 106 86 23 05 C20601 <CR> 
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and now the last two instructions (OUT and NOP): 

> P IOC D3F7 00 <CR> 



Finally, patch in the Exit SVC information at address 40: 

> P 40 00421A <CR> 



You'll examine the contents of memory later in this demonstration. 



Put Symbols into the Symbol Table 

Later in this demonstration, you will use symbols from the demonstration program (START, LOOP, TSIZE, 
AND TABLE) when communicating with OS/40. Whenever you use a symbol in a command, OS/40 consults 
a symbol table in 8540 system memory to find the value the symbol represents. Enter the following com- 
mand line to add the program symbols to the symbol table, along with their values: 

> ADDS START=100 L00P=106 -S TSIZE=5 TABLE =500 <CR> 



The ADDS command cannot provide all the symbol-related information that is provided by the SYMLO 
command (as in Cases 1 and 2) or the COM command (as in Case 3). Because this information is missing, 
some of the displays you produce later in this demonstration will not match the symbolic displays shown in 
this manual. For more information on the ADDS command, refer to the Command Dictionary of your System 
Users Manual. 



You've patched the demonstration program into program memory and placed the program symbols in the 
symbol table. Now it's time to run the program. 



RUN THE DEMONSTRATION PROGRAM 

From now until the end of the demonstration, the commands you are to enter are shown in lowercase. If you 
are not logged into an 8560, you may enter commands in either lowercase or uppercase. If you are using an 
8560, you must enter the name of every command in lowercase (and your system prompt is $, not > ). 



Now that you've loaded the program into memory, you need to: 

• verify that the program was loaded correctly; and 

• put values into the table in memory, for the program to add. 
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Check IVIemory Contents Again. Before you loaded the program, you filled memory locations 40 to 11 F 
with zeros. Look at the same memory area again with the following command line: 

> d 40 llf <CR> 

0123456789ABCDEF 

000040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000050 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000070 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000090 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOAO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOBO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOCO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOODO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOEO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOFO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000100 00 00 00 00 00. 00 00 00 00 00 00 00 00 00 00 00 

000110 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 



The object code is loaded in two different blocks: 

• The Z80 machine instructions are loaded at address 100 (specified by the first ORG directive in the 
source code). 

• The information for the Exit SVC is loaded at address 40 (specified by the second ORG directive). 



The contents of the table at address 500 are still undefined, but you'll put some values into the table in just a 
few minutes. 



Turn On Symbolic Debug. Enter the following command to turn on symbolic debug: 

> symd on <CR> 



Disassemble the Object Code. The Dl (Disassemble) command displays memory contents both in hexa- 
decimal notation and in assembly language mnemonics. You can use the Dl command to verify that the 
object code in memory corresponds to your source code. Enter the following command to disassemble the 
area of memory occupied by the executable part of your program: 

> di 100 lOe <CR> 



LOG 


INST 


MNEM 


OPER 


SECTION 


(DEMO) 






START 


210005 


LD 


HL,0500 


+000103 


0605 


LD 


B,05 


+000105 


AF 


XOR 


A 


LOOP 


86 


ADD 


A 1 UT.\ 


+000107 


23 


INC 


HL 


+000108 


05 


DEC 


B 


+000109 


C20601 


JP 


NZ,0106 


+00010C 


D3F7 


OUT 


(F7),A 


+00010E 


00 


NOP 





Compare the Dl display with the assembler listing you generated earlier, or refer back to Fig. 7C-8. 
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The line SECTION (DEMO) in the Dl display indicates that the object code being disassembled comes from 
the program section called DEMO. In fact, the entire memory area used by your program (location through 
the end of the table — location 504) belongs to section DEMO. This section was declared by the SECTION 
directive in the source code. 



The LOC (location) column of the Dl display contains information that enables you to correlate the display 
with your assembler listing. The symbols START and LOOP in the Dl display correspond to the labels 
START and LOOP in the source code. In the display, when a location does not correspond to a label in the 
symbol table, Dl substitutes the address of the instruction relative to the beginning of the section, as 
shown in the address field of your assembler listing. If you haven't loaded the pertinent symbols and related 
information into the symbol table (using a command such as SYMLO), the Dl command supplies absolute 
(actual) addresses in the LOC column. (Since section DEMO begins at address 0, the relative address, or 
offset, is the same as the absolute address in this display. This offset feature is much more useful for 
sections that don't start at address 0.) 



Now you've seen that your system can use the symbol table to translate numbers into symbols to make a 
display easier to read. Your system can also translate a symbol in a command line into an address. For 
example, since your system knows that the symbol START is equivalent to the address 1 00, you could have 
entered the Dl command in any of the following ways: 

di 100 lOE 

di START IDE 

di start start+Oe 

di 100 START+OE 



Notice that a symbol can be entered in either lowercase or uppercase. 



The feature that enables DOS/50 and OS/40 to correlate symbols from your program with the numbers they 
represent is termed symtx)lic debug. 



Put Values into the Table in Memory. The demonstration program sums five numbers from a table in 
memory. Use the P (Patch) command to place the numbers 1,2,3, 4, and 5 in the table. Do you remember 
what the address of the table is? It doesn't matter, as long as you remember that the symbol TABLE 
represents that address. 

> p table 0102030405 <CR> 



4 4 

address of string of bytes to be stored 

table: 500 at addresses 500 to 504 

Check the Contents of the Table. Use the D command to display the contents of the table. (When you 
don't specify an upper boundary for the area to be dumped, the D command dumps 16 bytes.) 
lower address: 500 



, upper address: omitted 

' I (defaults to lower address + OF) 



> d table <CR> 

0123456789ABCDEF 
000500 01 02 03 04 05 27 EB CF C3 EC EB B6 9D AB AF DB 
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Notice that bytes 500 to 504 (the table) contain the values you patched in. Bytes 505 to 50F contain random 
data left over from previous system operations. 



The following command dumps only the contents of the table: 

> d table table +tslze-l <CR> 

0123456789ABCD 
000500 01 02 03 04 05 



Start Program Execution 

Now enter the G (Go) command to start program execution at location 1 00, the transfer address specified by 
the END directive in the source code. (If you followed Case 4: Patch the Program into Memory, you must 
enter G START instead.) 

> _^ <CR> 

LOG INST MNEM OPER SP F A B C D E H L IX lY 
OOOIOF 00 NOP 0000 42 OF 00 00 00 00 05 05 0000 0000 

OOOIOF 00 <BREAK > 



The program executes, and when the Exit SVC occurs, the program breaks (stops), and the contents of the 
emulator registers are displayed. The accumulator contains the sum of the numbers in the memory table: 
1+2+3+4 + 5 = OF. 



MONITOR PROGRAM EXECUTION 

You have assembled, loaded, and executed the demonstration program. The rest of this demonstration 
shows you some commands for monitoring program execution. You can watch the changes in the emula- 
tor's registers and observe the effect of each instruction as the program proceeds. 



Trace All Instructions. The TRA (TRAce) command lets you observe the changes in the Z80 registers as 
the program proceeds. When you enter a TRA command and then start execution with the G command, 
display lines are sent to the system terminal. As each instruction executes, the display line shows the 
instruction (as in the Disassemble display) and the contents of the registers after that instruction has execut- 
ed. Enter the following command to trace all of the program's instructions: 

> tra all <CR> 



Enter the command G START (or G 100) to resume program execution at the begining of the program: 

> g start <CR> 
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; the program executes, the following 


trace is displayed 


. Remember that you can type CTR 


3 display < 


and CTRL-Q to resume the display. 






















LOG 


INST 


MNEM 


OPER 


SP 


F 


A 


B 


C 


D 


E 


H 


L 


IX 


lY 


SECTION 


(DEMO) 




























START 


210005 


LD 


HL,0500 


FFFF 


42 


OF 


00 


00 


00 


00 


05 


00 


0000 


0000 


+000103 


0605 


LD 


B,05 


FFFF 


42 


OF 


05 


00 


00 


00 


05 


00 


0000 


0000 


+000105 


AF 


XOR 


A 


FFFF 


44 


00 


05 


00 


00 


00 


05 


00 


0000 


0000 


LOOP 


86 


ADD 


A,(HL) 


FFFF 


00 


01 


05 


00 


00 


00 


05 


00 


0000 


0000 


+000107 


23 


INC 


HL 


FFFF 


00 


01 


05 


00 


00 


00 


05 


01 


0000 


0000 


+000108 


05 


DEC 


B 


FFFF 


02 


01 


04 


00 


00 


00 


05 


01 


0000 


0000 


+000109 


C20601 


JP 


NZ,0106 


FFFF 


02 


01 


04 


00 


00 


00 


05 


01 


0000 


0000 


LOOP 


86 


ADD 


A,(HL) 


FFFF 


00 


03 


04 


00 


00 


00 


05 


01 


0000 


0000 


+000107 


23 


INC 


HL 


FFFF 


00 


03 


04 


00 


00 


00 


05 


02 


0000 


0000 


+000108 


05 


DEC 


B 


FFFF 


02 


03 


03 


00 


00 


00 


05 


02 


0000 


0000 


+000109 


C20601 


JP 


NZ,0106 


FFFF 


02 


03 


03 


00 


00 


00 


05 


02 


0000 


0000 


LOOP 


86 


ADD 


A.{HL) 


FFFF 


00 


06 


03 


00 


00 


00 


05 


02 


0000 


0000 


+000107 


23 


INC 


HL 


FFFF 


00 


06 


03 


00 


00 


00 


05 


03 


0000 


0000 


+000108 


05 


DEC 


B 


FFFF 


02 


06 


02 


00 


00 


00 


05 


03 


0000 


0000 


+000109 


C20601 


JP 


NZ,0106 


FFFF 


02 


06 


02 


00 


00 


00 


05 


03 


0000 


0000 


LOOP 


86 


ADD 


A,(HL) 


FFFF 


08 


OA 


02 


00 


00 


00 


05 


03 


0000 


0000 


+000107 


23 


INC 


HL 


FFFF 


08 


OA 


02 


00 


00 


00 


05 


04 


0000 


0000 


+000108 


05 


DEC 


B 


FFFF 


02 


OA 


01 


00 


00 


00 


05 


04 


0000 


0000 


+000109 


C20601 


JP 


NZ,0106 


FFFF 


02 


OA 


01 


00 


00 


00 


05 


04 


0000 


0000 


LOOP 


86 


ADD 


A,(HL) 


FFFF 


08 


OF 


01 


00 


00 


00 


05 


04 


0000 


0000 


+000107 


23 


INC 


HL 


FFFF 


08 


OF 


01 


00 


00 


00 


05 


05 


0000 


0000 


+000108 


05 


DEC 


B 


FFFF 


42 


OF 


00 


00 


00 


00 


05 


05 


0000 


0000 


+000109 


C20601 


JP 


NZ,0106 


FFFF 


42 


OF 


00 


00 


00 


00 


05 


05 


0000 


0000 



LOC INST MNEM OPER 
+00010C D3F7 OUT (F7),A 
+000 IOC D3F <BREAK TRACE> 



SP F A B C D E H L IX lY 
FFFF 42 OF 00 00 00 00 05 05 0000 0000 



After the accumulator is cleared, it begins to store the sum of the numbers being added. The ADD A 
instruction adds a number from the table into the accumulator. At the end of the program, the accumulator 
contains the sum of the numbers you put into the table. 



Register B, the pass counter, is set to contain 5 (TSIZE) at the beginning of the program. It decreases by one 
(because of the DEC B instruction) each time a number is added into the accumulator. The program ends 
after register B reaches zero. 



The H-L register pair, set to contain 500 (TABLE) at the start of the program, increases by one each time a 
number is added to the accumulator. At the end of the program, the H-L register pair has been incremented 
five times and contains 505. 



Trace to the Line Printer. By adding the parameter > LPT to a command, you can direct that command's 
output to the line printer instead of to the system terminal. First, verify that your line printer is properly 
connected and powered up. Then enter the following command to execute the program with trace output 
directed to the line printer: 

> g start >LPT <CR> 



NOTE 
If you're operating in TERM mode with an 8560, use one of the following comrnands in place of the 
command shown: 
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g start lipir sends the display to the 8560 line printer. 

g start \>LPT sends the display to the line printer on the 8540 or 8550. 



Trace Jump Instructions Only. Another way to monitor the program's execution is to look only at the jump 
instructions. By tracing the jump instructions, you can still observe the changes in the registers, but you save 
time and space by not tracing the instructions within the loop. Enter the following command to trace only the 
jump instructions when the loop is being executed: 

> tra jmp loop 109 <CR> 





T 


T^ 






























i_-_ 


upper address 








Within this range, 






















only 


jump instructions 










Inw^r sififir^^^ 








are 1 


rskt^^f^ 
















(106) 










1 a\*K^ 












Again, start 


your program with the G command 


The following 


trace is 


displayed: 




> g start <CR> 




























LOG 


INST 


MNE^ 


OPER 


SP 


F 


A 


B 


c 


D 


E 


H 


L 


IX 


lY 


SECTION 


(DEMO) 




























START 


210005 


LD 


HL,0500 


FFFF 


42 


OF 


00 


00 


00 


00 


05 


00 


0000 


0000 


+000103 


0605 


LD 


B,05 


FFFF 


42 


OF 


05 


00 


00 


00 


05 


00 


0000 


0000 


■^000105 


AF 


XOR 


A 


FFFF 


44 


00 


05 


00 


00 


00 


05 


00 


0000 


0000 


-*-000109 


C20601 


JP 


NZ,0106 


FFFF 


02 


01 


04 


00 


00 


00 


05 


01 


0000 


0000 


^000109 


C20601 


JP 


NZ,0106 


FFFF 


02 


03 


03 


00 


00 


00 


05 


02 


0000 


0000 


+000109 


C20601 


JP 


NZ,0106 


FFFF 


02 


06 


02 


00 


00 


00 


05 


03 


0000 


0000 


+000109 


C20601 


JP 


NZ,0106 


FFFF 


02 


OA 


01 


00 


00 


00 


05 


04 


0000 


0000 


+00010C 


D3F7 


OUT 


(F7) ,A 


FFFF 


42 


OF 


00 


00 


00 


00 


05 


05 


0000 


0000 


+00010C 


D3F <BREAK 


TRACE > 

























As with the TRA ALL display, observe that register B (the pass counter) is decremented, the H-L register 
pair (the table pointer) is incremented, and the accumulator stores the sum of the numbers from the table. 
With the TRA JMP selection in effect, the instructions within the loop are not displayed. 



Check the Status of the Trace. The TRA command without any parameters displays the trace conditions 
that are currently set. Because you can have up to three trace selections in effect at the same time, it is 
useful to be able to see which selections are active. Check your trace status with the following command 
line: 

> tra <CR> 

TRACE ALL, 000000, OOFFFF 
TRACE JMP, LOOP, 000109 



:_ ^tt^^i. t^. 



,^^^ — ^ — , ri A-. A r\c 



r\M MLL. la III eiicui lui ciuurebbCb u lu luo, i 



RA JMP is In effect for addresses 106 to 



109, and TRA ALL is again in effect for addresses 10A to FFFF. 
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Set a Breakpoint after a Specific Instruction. Now that you've seen how the program adds the numbers 
together, here's a new task: to add only the third and fourth numbers from the table. To perform this task, 
you want the pass counter to contain 2, and the table pointer to contain 502 (the address of the third number 
in the table). You can accomplish these changes without altehng the object code in memory. First, stop 
program execution after the pass counter and the table pointer have been set. Next, while the program is 
stopped, enter new values for the pass counter and table pointer. When execution resumes, the program 
treats the new values as if they were the original programmed value. 



Enter the following command line to trace all of the instructions as the program executes: 

> tra all <CR> 



Check the status of the trace with the following command line: 

> jtra <CR> 

TRACE ALL, 000000, OOFFFF 



The TRA ALL command just entered makes the earlier TRA selections obsolete. 



Now you set a breakpoint so that the program stops after the table pointer and pass counter have been set. 
The following command causes the program to stop after it executes the LD B instruction at address 103: 

> bk 1 103 <CR> 



4 4 
I 



breakpoint address 

. breakpoint number 
(can be 1 or 2) 



Use the G command to start program execution: 

> g start <CR> 



LOG 


INST 


MNEM 


OPER 


SP 


SECTION 


(DEMO) 








START 


210005 


LD 


HL,0500 


FFFF 


+000103 


0605 


LD 


B,05 


FFFF 


+000103 


060 <BREAK 


TRACE, 


BKPTl > 



IX lY 



FFFF 42 OF 00 00 00 00 05 00 0000 0000 
FFFF 42 OF 05 00 00 00 05 00 0000 0000 



The TRA ALL command enabled display of all instructions up to and including the instruction at the 
breakpoint. 



Set New Values in Pass Counter and Table Pointer; Check Results. Now that you've reached the break- 
point, you can change the contents of the registers while execution is stopped. The break display shows that 
register B (the pass counter) contains 5, and the H-L register pair (the table pointer) contains the address 
500. Use the S (Set) command to set the number of passes to two and set the table pointer to 502: 

> S B =2 L =2 <CR> 
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The S command does not produce a display, but you can use the DS (Display Status) command to check the 
values in the registers you changed. DS displays the contents of each emulator register and status flag. 
Check the result of the previous S command with the following command line: 

> d^ <CR> 

PC=0105 SP=FFFF F=42 A=OF B=02 C=00 D=00 E=00 H=05 L=02 

IX=0000 IY=0000 AF=00 AA=00 AB=00 AC=00 AD=00 AE=00 AH=00 AL=00 

IFF1=0 IFF2=0 IM=0 1=00 R=37 



The DS display shows that the pass counter and table pointer now contain the new values. 



Resume Program Execution. If you enter the G 
where it left off. Resume program execution after 

> g <CR> 

MNEM OPER 



command with 
the breakpoint 



no parameters, program execution starts 
with the following command: 



LOG INST 
SECTION (DEMO) 

+000105 AF XOR A 

LOOP 86 ADD A , { HL ) 

+000107 23 INC HL 

+000108 05 DEC B 

+000109 C20601 JP NZ,0106 

LOOP 86 ADD A,(HL) 

+000107 23 INC HL 

+000108 05 DEC B 

+000109 C20601 JP NZ,0106 

+00010C D3F7 OUT (F7),A 
+00010C D3F <BREAK TRACE> 



SP 

FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 



FAB 



44 00 
00 03 
00 03 
02 03 
02 03 
00 07 
00 07 
42 07 
42 07 
42 07 



02 00 
02 00 
02 00 
01 00 
01 00 
01 00 
01 00 
00 00 
00 00 
00 00 



D E H 

00 00 05 
00 00 05 
00 00 05 
00 00 05 
00 00 05 
00 00 05 
00 00 05 
00 00 05 
00 00 05 
00 00 05 



L IX 

02 0000 

02 0000 

03 0000 
03 0000 
03 0000 

03 0000 

04 0000 
04 0000 
04 0000 
04 0000 



lY 

0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 



Notice that the program performed two passes through the loop, and that the program added the third and 
fourth numbers in the table: 3+-4=7. 



Delete the Demonstration Run Files 

Now that you've finishd the demonstration run, you can delete the source file, object file, listing file, and load 
file. If you're using an 8550, the source and load files are still available to you on the Z80 emulator installation 
disk. If you're using an 8560, remember that once you delete the source file (asm) , there is no way of 
recovering it. 



Delete 8550 Files. If your files are on the 8550, use the following procedure to delete them. First use the 
USER command to move from the DEMO directory back in to the directory you were in at the start of the 
demonstration. Recall that you marked that directory with the brief name /ROOT. 

> USER /ROOT <CR> 



Now enter the following command to delete the DEMO directory and the files it contains: 

> DEL DEMO/* DEMO <CR> 
Y <CR> 



Delete ASM 

Delete LOAD 

Delete OBJ 

Delete ASML 

Delete DEMO 



Y <CR> 

Y <CR> 

Y <CR> 

Y <CR> 
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Before deleting each file, DOS/50 asl<s you whether you really want to delete it. You type Y for yes. 



Delete 8560 Files. If your files are on the 8560, use the following procedure to delete them. Enter the 
following command to remove all files in the working directory, including the source file: 

$ rm * <CR> 



Now move from the demo directory back into the parent directory and remove the demo directory itself: 

$ cs . . <CR> 

$ rmdir demo <CR> 



Turn Off Your System 

For instructions on turning off your 8540 or 8550, refer to the Learning Guide of your System Users Manual. 



SUMMARY OF Z80 EMULATOR DEMONSTRATION RUN 

You have assembled, loaded, executed, and monitored the demonstration run program. You have used the 
following commands: 



SEL — selects the Z80 assembler and emulator 

ASM — creates object code from an assembly language program 

LINK — links object code into a load module 

F — fills an area of memory with a specified value 

D — displays memory contents in ASCII and hexadecimal format 

LO — loads object code into memory 

SYMLO — loads program symbols for use in symtx)lic debug 

Dl — translates memory contents into assembly language mnemonics 

P — patches a string of bytes into memory 

SYMD — turns on symbolic debug displays 

G — begins or resumes program execution 

TRA — selects instructions to t>e traced during program execution 

BK — sets a breakpoint 

S — modifies emulator registers 

DS — displays emulator registers 
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INTRODUCTION 

This section is designed to be inserted into Section 7 of the 8550 
System Users Manual (DOS/50 Version 2) or the 8540 System Users Manual. 
This Emulator Specifics section explains the features of the 8550 and 
8540 systems that are unique to the 8048/8021/804lA/8022 emulator. 
Throughout the section, "your System Users Manual" refers to the 8550 
System Users Manual or the 8540 System Users Manual, and "the operating 
system" refers to DOS/50 Version 2 or OS/40. The 8048/802 1/8041 A/8022 
Demonstration Run is designed to be used with Section 1 , the Learning 
Guide of your System Users Manual; the rest of this section contains 
reference material. 



GENERAL INFORMATION 



8048/802 1/8041 A/8022 EMULATOR HARDWARE CONFIGURATIONS 

In order for the 8048/802 1/8041 A/8022 emulator to function correctly, it 
must be connected to the prototype control probe that is appropriate for 
the microcomputer being emulated. Table 7H-1 lists the microcomputers 
supported by the 8048/802 1/8041 A/8022 emulator and gives the 
corresponding hardware configurations. 



Table 7H-1 
Microcomputers Supported by the 8048/802 1/8041 A/8022 Emulator 

+ 

Microcomputer | Hardware Configuration 

8041 A/8741 A I 8041A Prototype Control Probe 

+ 

8022 I 8022 Prototype Control Probe 

+ 

8021 I 8048/8021 Prototype Control Probe with 

I 8021 Prototype Control Probe Adapter (*a) 

+ 

8048/8648/8748/8035 I 8048/8021 Prototype Control Probe (»a) 

+ 

8049/8039/8039-6 I 8048/8021 Prototype Control Probe (*a) 

+ 

(*a) DIP switches on the 8048/8021 Prototype Control Probe select the 
microcomputer to be emulated, the prototype clock rate, and the presence 
or absence of external program memory. These switches are described in 
the 8048/802 1/8041 A/8022 Emulator Processor Installation Manual. 
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TERMINOLOGY 

The term 8048 refers collectively to the 8048 and to those 
microcomputers that differ from the 8048 only in the form of on-board 
ROM (the 8648, 8748, and 8035). The term 8048/8049 refers collectively 
to those microcomputers that support the 8048 instruction set (the 3048, 
8648, 8748, 8035, 8049, 8039, and 8039-6). The terms 8048 family and 
8048/802 1/8041 A/8022 refer collectively to all microcomputers supported 
by the 8048/8021/804lA/8022 emulator, as listed in Table 7K-1. The term 
8041A refers to the 8741 A as well as to the 8041 A. 

In this Emulator Specifics section, the term program memory refers to 
the on-board ROM and/or external memory in which 8048/802 1/8041 A/8022 
program instructions are stored. The term 8550/8540 program memory 
refers to the RAM in your 8550 or 8540 that may be used as a substitute 
for memory in the microcomputer and/or prototype. Throughout the other 
sections of your System Users Manual, the term program memory refers to 
8550 or 8540 program memory. 

EMULATOR-SPECIFIC COMMANDS, PARAMETERS, AND DISPLAYS 



SEL Selecting an Emulator 

The SEL (SELect) command allows you to select the emulator you want to 
use with your 8550 or 8540. The following command line selects the 
8048/8021/8041 A/8022 emulator and assembler: 

> SEL 8048 <CR> 

Circuitry in the prototype control probe tells the operating system 
which microcomputer in the 8048 family is being emulated. For more 
information, refer to the "8048/8021/8041 A/8022 Emulator Configurations" 
discussion at the beginning of this section. 

Enter the following command line to select the 8048 assembler on the 
8560: 



$ uP=8048; export uP <CR> 



Byte/Word Parameter 

Several commands offer you the choice of operating on memory on a 
byte-oriented or word-oriented basis. In affected commands, this choice 
is represented by the -B or -W parameter. For the 8048/8021/8041 A/8022 
emulator, the default value is -B (Byte). 



Symbolic Debug 

The 8048/8021/8041A/8022 emulator supports the use of symbolic debug. 
Some of the displays in this document include symbolic debug 
information. 
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MAP Mapping Memory 

The MAP command assigns 128-byte blocks of memory either to 8550/8540 
program memory or to prototype memory. For the 8048/802 1/8041 A/8022 
emulator, only blocks in the following address ranges can be mapped: 

0000 — OFFF (8048/8049 program memory) 

2000— 20FF (8048/8049 external data memory) 

NOTE 



No memory mapping is possible for the 8021, 8041 A, or 
these microcomputers do not support external memory. 



8022: 



For more information on memory considerations, refer 
Considerations" discussion later in this section. 



to the "Special 



EVT Address Parameter 

If you are using the Real-Time Prototype Analyzer (RTPA) option with 
your 8550, the addresses used in the. EVT command line must reflect the 
memory mapping conventions defined in the "Special Considerations" 
subsection later in this section. (The RTPA option is not supported on 
the 8540.) 



TTA Bus Operation Designators 

Table 7H-2 lists the 8048/8021/8041 A/8022 bus operation 
recognized by the Trigger Trace Analyzer's BUS command. 



designators 



Table 7H-2 
8048/8021/8041 A/8022 Bus Operation Designators 



Symbol 


Bus Operation Type 


CLR 


All types 


F 


Instruction fetches 


I 


I/O operations (SVCs only) 


NF 


Non-fetches 


M 


Memory accesses 


RD 


Reads 


WT 


Writes 
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Setting Breakpoints 

The 8048/802 1/8041 A/8022 emulator allows you to specify up to two 
breakpoints with the BK (BreaKpoint) command. Breakpoints should be 
restricted to the ranges — OFFF (program memory) and 2000 — 20FF 
(8048/8049 external data memory). The 8048/S021/804lA/8022 emulator 
cannot monitor accesses to internal data memory. Refer to the "Special 
Considerations" discussion later in this section for information on the 



ismory limitations of your microcomputer 



Memory Allocation Commands 

The Memory Allocation Controller (MAC) option cannot be used with the 
8048/8021/8041A/8022 emulator. The 8048/8021/804lA/8022 emulator does 
not use the MEMSP command, and does not support memory space qualifiers 
or expressions. The 8048 family emulator supports the AL (ALlooate) 
command, as described in the Command Dictionary of your System Users 
Manual. The DEAL, MEM, and NOMEM commands are not valid with the 
8048/802 1/8041 A/8022 emulator, 

NOTE 



You should avoid allocating memory in the range 2000 — 20FFH 
and in the range 4000 — 407FH. These memory ranges are used to 
emulate External Data Memory and Internal Data Memory, 
respectively. Allocation of memory in these ranges may yield 
unexpected results. 



Register Designators 

Table 7H-3 alphabetically lists the symbols used by DOS/50 and OS/40 to 
designate the registers and flags used by the microcomputers in the 8048 
family. The table provides the following information for each symbol: 

• the microcomputers for which that symbol is used 

• a description of the register or flag that the symbol 
represents 

• the size of the register or flag 

• the value assigned to the register or flag by the RESET command 

• whether the register or flag can be assigned a value by the S 
(Set) command 



Figure 7H-1 shows the contents of the 8048/8021/8041 A/8022 program 
status word. 
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Table 7H-3 
8048/8021/8041 A/8022 Registers and Flags 



H 

DOS/50 


1 — 
8 


8 8 


81 


h H 


Size 


h H 

Value 


f. 


or 1 













in 


After 


Altered 


OS/40 1 


4 


2 4 


21 




Bits 


RESET 


by S 


Symbol 


8 


1 1 


21 


Description 


(*a) 


(»b) 


Command? 


A 1 


X 


X X 


x! 


Accumulator 


8 


NC 


yes 


AO— A7 i 


X 


X 




Alternate registers — 7 


8 each 


NC 


yes 


AC 


X 


X X 


X 


Auxiliary carry flag: 
bit 6 of PSW 


1 





yes 


AN 






X 


Analog input pin 


1 


NC 


yes 


CHIP 


X 


X X 


X 


Microcomputer name 


NA 


NC 


no 


CY 


X 


X X 


X 


Carry flag: bit 7 of PSW 


1 





yes 


DMA 




X 




EN DMA instruction exe- 
cuted since last RESET? 
1=yes; 0=no 


1 





no 


EI 


X 


X 


X 


External interrupt flag: 
1=enabled; 0=disabled 


1 





yes 


EPM 


X 






Switch set to enable 

external program memory? 
Y=yes; N=no 


NA 


NC 


no 


FO 


X 


X 




Flag 0: bit 5 of PSW 


1 





yes 


F1 


X 


X 




Flag 1 


1 





yes 


FLG 




X 




EN FLAGS instruction exe- 
cuted since last RESET? 
1=yes; 0=no 


1 


NC 


no 


IBF 




X 




Input buffer full flag 


1 


NC 


no 


IIP 


X 


X 


X 


Interrupt in progress 
flag: Y=yes; N=no 


NA 


N 


no 


MB 


X 






Memory bank 


1 





yes 


DBF 




X 




Output buffer full flag 


1 


NC 


no 


PC 


X 


X X 


X 


Program counter 


12 





no 


PSW 


X 


X X 


X 


Program status word (*c) 


8 


or 8 


yes 


RO— R7 


X 


X X 


X 


Registers — 7 


8 each 


NC 


yes 


RB 


X 


X 




Register bank: 
bit 4 of PSW 


1 





yes 


RETURN 


X 


X X 


X 


Value of last word pushed 


16 


(*d) 


no (»d) 


STACK 


X 


X X 


X 


Stack pointer: 08 to 16, 
derived from bits — 2 
of PSW 


NA 


08 


no (*d) 


STF 




X 




STS flags 


4 





no 


TC 


X 


X X 


X 


Timer/counter selector: 
Orstop; 1=timer; 
2=counter 


2 





yes 


TF 


Ix 


X X 


X 


Timer overflow flag 


1 1 





yes 


TI 


!x 


X 


X 


Timer/counter interrupt 
1 flag: 1=enabled; 
Ordisabled 


1 





yes 


TR 


Ix 


X X 


X 


Timer/counter 


8 


NC 


yes 



(*a) NA refers to information not maintained by the microcomputer itself. 

(*b) NC means not changed by RESET. 

(*c) Figure 7H-1 shows the contents of the program status word. 

(*d) You cannot use the S command to alter STACK or RETURN directly; 

however, these values depend on bits — 2 of the PSW, which can be 

directly altered using S. 
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Bit # 



CY 



AC 



FO 



RB 



stack pointer 

J L_ 



not usea 

register bank switch 

flag 

auxiliary carry flag 

carry flag 



(3569-2)3967-1 



Fig. 7H-1. 8048/8021/8041A/8022 program status word. 



PS Sample Status Display 

The DS (Display Status) command displays the status and register 
contents of the emulator. All numbers in the DS display are 
hexadecimal. Here is an example of a DS display line produced by the 
3048/8021/8041A/8022 emulator when it is used to emulate an 8048: 



> DS <CR> 

PC CHIP EPM A PSW TR RB 
010A 8048 Y 11 00 00 



REGISTERS 
R0-R7= 19 36 07 A6 FD 00 00 00 
A0-A7= 86 00 2F 40 49 09 7D 00 



IIP EI TI TC MB STACK RETURN TF FO F1 AN STF DMA IBF DBF FLG 
N 08 1F06 



The DS display differs slightly for the 8021, 8022, and 8041A. 
7H-3 explains the symbols displayed by DS. 



Table 



For the 8048/8021/804lA/8022 emulator, the short and long forms of the 
DS display are the same: DS -L gives the same display as DS. 
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RESET Resetting Emulator Status 

The RESET command sends a hardware reset signal to the emulating 
microcomputer. The "Value After RESET" column of Table 7H-3 indicates 
which registers are affected by the RESET command. 

Example. Suppose the DS command returns the following status: 

> DS <CR> 

PC CHIP EPM A PSW TR RB REGISTERS 

090A 8048 Y 02 FF 40 1 R0-R7= 86 00 2F 40 49 09 7D 00 

A0-A7= 19 36 07 A6 FD 00 FF 00 

IIP EI TI TC MB STACK RETURN TF FO F1 AN STF DMA IBF OBF FLO 
N 1 1 2 1 16 8208 1 1 1 

Enter the RESET command; then use DS to check the results, 

> RESET <CR> 

> DS <CR> 

I register bank becomes the 
I I I current register bank 

V V V I 

PC CHIP EPM A PSW TR RB v REGISTERS 

0000 8048 Y 02 08 40 R0-R7= 19 36 07 A6 FD 00 FF 00 

A0-A7= 86 00 2F 40 49 09 7D 00 

IIP EI TI TC MB STACK RETURN TF FO F1 AN STF DMA IBF OBF FLG 
N 08 1F06 



I ! I i i 



The arrows show the changed registers. 
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The DI (Disassemble) command translates object code in memory into 
assembly language instructions. DI displays object code, assembly 
language mnemonics, and operands. Here is an example of 8048 DI output: 

> DI 100 10E <CR> 



LOC 


INST 


MNEM 


OPER 




000100 


BQia 


MOV 


R1.?n2 




000102 


BF05 


MOV 


R7,#05 




000104 


27 


CLR 


A 




000105 


61 


ADD 


A,§R1 




000106 


19 


INC 


R1 




000107 


EF05 


DJNZ 


R7,#05 


0105 


000109 


AA 


MOV 


R2,A 


= = = 


00010A 


23F7 


MOV 


A,#F7 


1 


00010C 


00 


NOP 




eff 


00010D 


A3 


MOVP 


A,@A 


of 


00010E 


00 


NOP 







effective address 

of branch instruction 



+ — operand(s): address, registers, or data 
being operated on 



instruction mnemonic 
machine language instruction 
address of instruction 



TRA Sample TRAce Display 

The TRAce command establishes the conditions for displaying trace lines 
during program execution. For the 8021 and 8022, the TRA -L display is 
the same as the default (TRA -S) display. For the 8048/8049 and the 
8041 A, the TRA -L display includes the contents of the alternate 
registers (AO — A7) in addition to the TRA -S information. 

NOTE 



When TRAce conditions have been set, the emulator runs at 
slower than normal processing speeds and RTPA breakpoints are 
suppressed. 



Here is an example of 8048 TRAce output; 
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> TRA ALL <CR> 

> G <CR> 

LOG INST MNEM 

000104 27 GLR 

000105 61 ADD 

000106 19 ING 

000107 EF05 DJNZ 



8048 Commands and Displays 



OPERAND EADD A PSW FLAGS TR RB RO R1 R2 R3 R4 R5 R6 R7 



A 

A,@R1 

R1 



00 08 00 00 00 
03 08 00 00 00 
03 08 00 00 00 



R7, 05H 0105 03 08 00 00 00 



19 34 OF A6 FD 00 BE 02 

19 34 OF A6 FD 00 BE 02 

19 35 OF A6 FD 00 BE 02 

19 35 OF A6 FD 00 BE 01 



I registers R0-R7 

I 

+ — register bank 

+ — timer/counter 

+ — + — miscellaneous flags 

+ — program status word 

+ — accumulator 

+ — effective address of branch instruction 

+ — operand(s) 

+ — instruction mnemonic 

+ — machine language instruction 

+ — address of instruction 



The two FLAGS bytes in the TRAce display contain the following 
information: 



Byte 
left 



Bit 



7 IIP interrupt in progress flag (most significant bit) 

6 EI external interrupt flag 

5 TI timer/counter interrupt flag 

4 TF timer overflow flag 

3 MB memory bank 

2 F1 software flag 1 

1-0 TG timer/counter selector 



right {7-4 

8041A { 3 

only { 2 

{ 1 

{ 





STF STS flags 

DMA 1 if EN DMA instruction executed since last RESET 

IBF input buffer full flag 

DBF output buffer full flag 

FLG 1 if EN FLAGS instruction executed since last RESET 

AN analog input pin (8022 only) 



For more information on these flags, refer to Table 7H-3. 
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SERVICE CALLS 

Service calls (SVCs) enable your program to use many system capabilities 
of your 8540, 8550, or 8560 while your program is running on the 
emulator processor. 

An SVC is invoked with the following 8048/802 1/8041 A/8022 instruction 
sequence: 

NOP 

MOVP A,§A 

wur 

The value in the accumulator at the time of the SVC directs the system 
to a specified memory address called the SRB pointer (which points to 
the SRB — the Service Request Block) . The SRB pointer tells the system 
where to find the data (stored in the SRB) that informs the system which 
function to perform. Refer to the Service Calls section of your System 
Users Manual for an explanation of service calls, service request 
blocks, and SRB pointers. 

Your program can point to eight SRBs at any one time. (Under certain 
circumstances, your program can store new addresses in the SRB pointers 
as it executes. See the following discussion, "SVC Design Features.") 
Table 7H-4 shows the default addresses for the eight SRB pointers. 
These addresses and their associated accumulator values can be altered 
with the SVC command to suit your program requirements. See the Command 
Dictionary section of your System Users Manual for syntax and use of the 
SVC command. 



SVCs in Modes 1 and 2 

The 8048/802 1/8041 A/8022 emulator does not support SVCs in emulation 
modes 1 or 2. 



Table 7H-4 
8048/8021/8041A/8022 Service Calls 









SVC 


Value in 


SRB Pointer 


Number 


Accumulator 


Location 


1 


F7 


40,41 


2 


F6 


42,43 


3 


F5 


44,45 


4 


F4 


46,47 


5 


F3 


48,49 


6 


F2 


4A,4B 


7 


F1 


4C,4D 


8 


FO 


4E,4F 
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SVC Demonstration 

Figure 7H-2 lists an 8048/8021/8041 A/8022 program that uses four SVC 
functions: Assign Channel, Read ASCII, Write ASCII, and Abort. The 
program's algorithm is explained in the Service Calls section of your 
System Users Manual, which demonstrates a version of the program written 
in 8085A assembly language. You can perform a parallel demonstration 
with the 8048/8021/8041 A/8022 emulator and A Series Assembler using the 
program in Fig. 7H-2. 

NOTE 



The program shown in Fig. 7H-2 is written for an A Series 
assembler. To make this acceptable for a B Series assembler 
(as required by an 856O), change each double quote (") to a 
single quote ( ' ) . 
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; SSSSS 


V V 


CCCCC 






f s 


V V 


C 






; SSSSS 


V V 


C DEMONSTRATION. 8048 EMULATOR 


; s 


V V 


C 






; SSSSS 


V 


CCCCC 








ORG 


40H 




; BEGINNING OF SRB VECTOR 




BYTE 


HI(SRBIFN), 


LO(SRBIFN) 




BYTE 


HI(SRB2FN), 


L0(SRB2FN) 




BYTE 


HKSRBBFN), 


L0(SRB3FN) 




BYTE 


HI(SRB4FN), 


L0(SRB4FN) 




BYTE 


HI(SRB5FN), 


L0(SRB5FN) 


• 

> 


END OF 


SRB VECTOR 








ORG 50H 




; SET UP SRB AREAS 


• 

> 


SRB1 = 


ASSIGN "CON] 


Ml TO 


CHANNEL 


SRB1FN 


BYTE 


10H 




; ASSIGN 




BYTE 


OOH 




; TO CHANNEL 


SRB1ST 


BLOCK 


01H 




; STATUS RETURNED HERE 




BLOCK 


02H 




; BYTES 4 AND 5 NOT USED 




BYTE 


05H 




; LENGTH OF "CONI"+<CR> 




BYTE 


HI(CONI) 




; POINTER TO 




BYTE 


LO(CONI) 




; "CONI"+<CR> 


> 


END OF 


SRB1 






• 


SRB2 = 


ASSIGN "LPT' 


• TO ( 


:hannel 1 


SRB2FN 


BYTE 


10H 




. ACOTnuT 




BYTE 


01H 




; TO CHANNEL 1 


SRB2ST 


BLOCK 


01H 




; STATUS RETURNED HERE 




BLOCK 


02H 




; BYTES 4 AND 5 NOT USED 




BYTE 


04H 




; LENGTH OF "LPT"+<CR> 




BYTE 


HI (LPT) 




J POINTER TO 




BYTE 


LO(LPT) 




; "LPT"+<CR> 


• 
» 


END OF 


SRB2 






1 . 
i ) 


SRB3 = 


READ ASCII LINE 


FROM CONI (CHANNEL 0) 


SRB3FN 


BYTE 


01K 




; READ ASCII 




BYTE 


OOH 




; FROM CHANNEL 


SRB3ST 


BLOCK 


01H 




; STATUS RETURNED HERE 




BLOCK 


01H 




; BYTE 4 NOT USED 




BLOCK 


01H 




; BYTE COUNT RETURNED HERE 




BYTE 


OOH 




; 256 BYTES IN OUR BUFFER 




BYTE 


HI (BUFFER) 




; POINTER TO 




BYTE 


L0( BUFFER) 




; OUR BUFFER 


• 


END OF 


SRB3 






5 


SRB4 = 


WRITE ASCII 


LINE 


TO LPT (CHANNEL 1) 


SRB4FN 


BYTE 


02H 




; WRITE ASCII 




BYTE 


01H 




; TO CHANNEL 1 


SRB4ST 


BLOCK 


01H 




; STATUS RETURNED HERE 




BLOCK 


01H 




; BYTE 4 NOT USED 




BLOCK 


01H 




; BYTE COUNT RETURNED HERE 




BYTE 


OOH 




; 256 BYTES IN OUR BUFFER 




BYTE 


HI (BUFFER) 




; POINTER TO 




BYTE 


L0( BUFFER) 




; OUR BUFFER 


> 


END OF 


SRB4 






> 


SRB5 = 


ABORT (CLOSE ALL 


CHANNELS AND TERMINATE) 


SRB5FN 


BYTE 


1FH 




; ABORT 




BLOCK 


07H 




; BYTES 2 THROUGH 8 NOT USED 




END OF 


' SRB5 






i 
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Fig. 7H-2. 8048 SVC demonstration program listing (part 1 of 2). 
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BUFFER 


BLOCK 


100H 


; OUR I/O AREA 


CON I 


ASCII 


"CONI" 


; ASCII OF "CONI" 




BYTE 


ODH 


; + <CR> 


LPT 


ASCII 


"LPT" ; 


ASCII OF "LPT" 




BYTE 


ODH 


+ <CR> 




END OF 


DATA DEFINITIONS 






BEGINNING OF EXECUTABLE CODE 


START 


ORG 


10H ; 


ENTRY POINT INTO PROGRAM 




MOV 


A,#0F7H 


CALL SVC1 




NOP 


■ 


TO ASSIGN "CONI" 




MOVP 


A,@A ; 


TO CHANNEL 




NOP 








MOV 


A,#L0(SRB1ST) 


; CHECK THE STATUS 




MOVP 


A,§A 


; TO SEE IF ALL WENT WELL 




JNZ 


ABORT 


; NO? STOP EVERYTHING 




MOV 


A,#0F6H 


; CALL SVC2 




NOP 




; TO ASSIGN "LPT" 




MOVP 


A,@A 


; TO CHANNEL 1 




NOP 








MOV 


A,#L0(SRB2ST) 


; CHECK THE STATUS 




MOVP 


A,@A 


; TO SEE IF ALL WENT WELL 




JNZ 


ABORT 


; NO? STOP EVERYTHING 


LOOP 


MOV 


A,#0F5H 


; CALL SVC 3 




NOP 




; TO READ A LINE 




MOVP 


A,@A 


; FROM "CONI" 




NOP 




; INTO THE BUFFER 




MOV 


A,#L0(SRB3ST) 


; CHECK THE STATUS 




MOVP 


A,@A 


; TO SEE IF ALL WENT WELL 




JNZ 


ABORT 


; NO? STOP EVERYTHING 




MOV 


A,#0F4H 


; CALL SVC4 




NOP 




; TO WRITE THE LINE 




MOVP 


A,§A 


; FROM THE BUFFER 




NOP 




; TO "LPT" 




MOV 


A,#L0(SRB4ST) 


; CHECK THE STATUS 




MOVP 


A,@A 


; TO SEE IF ALL WENT WELL 




JZ 


LOOP 


; YES? BACK TO READ ANOTHER LINE 
; NO? FALL THROUGH TO TERMINATION 


ABORT 


MOV 


A,#0F3H 


; CALL SVC5 




NOP 




; TO DO THE ABORT 




MOVP 


A,§A 






NOP 








END 


START 


; END OF PROGRAM 

3967-11 



Fig. 7H-2. 8048 SVC demonstration program listing (part 2 of 2). 

This program shows the use of four 8550 service calls. The 
program's algorithm is explained in the Service Calls section 
of your System Users Manual. The program accepts a line of 
ASCII characters from the system terminal; then, when it 
receives a RETURN character, the program writes the line to 
the line printer and accepts another line. (On the 8550, 
output to the line printer is buffered. No text is printed 
until the line printer buffer in the 8501 becomes full or the 
program ends.) To terminate the program, enter a CTRL-Z while 
the program is waiting for input. 
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SVC DESIGN FEATURES 

SVC data blocks (Service Request Blocks, SRB pointers, and I/O buffers) 
can reside in either of the following address ranges s 

0000 — OFFF program memory (internal and external) 
2000 — 20FF external data memory 

SVC data blocks cannot reside in internal data memory. If you are 

ciuuxaoxiig dii KJKjc I , \j\jc.c.f vji uu-t in, CA.oci iiax \aauci uicuiv/i j xo iiv/i/ 

available, and program memory is limited to 400H bytes (for the 8021 and 

Rnillfl'^ Qv. AnOH b"t'^« ( fnr* t^A fin95^ P^r* mr>r»a -I nf rtvmaf inn r»iaf<ar» fn 

Figure 7H-3 and the discussion of memory mapping under the heading 
"Special Considerations" . 

If you are emulating an 8048/8049, programming considerations may 
require you to put some SVC data blocks in external data memory. For 
example, suppose you have a program that places information in an I/O 
buffer, and then uses an SVC to write out the contents of the buffer. 
If the information is read directly into the buffer and undergoes no 
further change (as in the preceding SVC demonstration program), the 
buffer can reside in program memory. Otherwise the buffer must reside 
in external data memory, because there are no 8048/8021/8041A/8022 
instructions that write to program memory. 

For information on allocating code to different types of memory, refer 
to the heading "Designating Memory Areas in Assembly Language Programs" 
in the Special Considerations subsection. 



Moving Data Into and Out of Program Memory 

The 8021, 8041 A, and 8022 cannot access external memory. To provide a 
one-byte output buffer for these microcomputers, DOS/50 and OS/40 allow 
your program to change the contents of byte of program memory. The 
following instruction sequence is used to move the contents of the 
accumulator to program memory location Oi 

NOP 

MOVX @R1,A 

The following instruction sequence is used to move the contents of 
npncram memor^ location to the accumulator i 

NOP 

MOVX A.§R1 
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NOTE 



Whenever a NOP instruction is followed by a MOVX instruction, 
DOS/50 or OS/40 process the instruction sequence as an access 
to program memory location 0. The contents of register R1 and 
the selected register bank are ignored. 

The NOP — MOVX sequences may be used when emulating any of the 
microcomputers in the 8048 family. However, before you 
execute these instruction sequences, make sure your 8550 or 
8540 is in emulation mode and TRAce is OFF. Avoid using 
these sequences unless you're accessing program memory 
location 0. 



Example. The following assembler directives set up an output buffer in 
bytes and 1 of program memory. Your program can write to byte using 
the NOP — MOVX instruction sequence. Byte 1 contains a RETURN character 
to mark the end of the buffer. 



ORG 
CHARBUF BLOCK 1 

BYTE ODH 



BYTE OF PROGRAM MEMORY 
USED AS AN OUTPUT BUFFER. 
BUFFER ENDS IN <CR>. 
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SPECIAL CONSIDERATIONS 

The emulating microcomputer for the 8048/8021 /804l A/8022 emulator is 



contained at all times on the prototype control probe, rather than on 
the emulator processor module (as with most other emulators). The 
8048/8021 prototype control probe contains an 8039 microcomputer, and 
the 8041 A and 8022 prototype control probes each contain an 8035 
microcomputer. Since the emulating microcomputer is not the same as the 
microcomputer being emulated, certain special considerations must be 
noted here* 

Other considerations of interest to users are also outlined in this 
subsection. First, considerations common to all microcomputers in the 
8048 family are described. Then, considerations that apply only to 
certain devices are described. 



CLOCK RATE 

The frequency of the emulator clock, used in emulation mode 0, is 5.0 
MHz. Table 7H-5 gives the maximum allowable frequencies for the 
prototype's clock, used in modes 1 and 2. 

NOTE 



For all microcomputers, the prototype clock frequency must be 
at least 2.0 MHz in order to fulfill the clock requirement of 
the emulating 8035 or 8039 microcomputer. 



Table 7H-5 
Maximum Allowable Clock Frequencies 

+ 

! Maximum Allowable Clock Frequency 

+ — • + + + 

I I 8048, 8648, I I 

I 8049, 8039 I 8748, 8035, I 8041 A, I 

Emulation Mode I (»a) I 8039-6 i 8741 A I 8022 

Mode 1 (Mapped | 11.0 MHz ! 6.0 MHz ! 6.0 MHz ! 3.58 MHz 
to 8550)" I (»b) i i 1 

+ + + + 

Mode 1 (Mapped I 11.0 MHz I 6.0 MHz I External (prototype) 
to Prototype) I I I memory is not 

and Mode 2 I I I addressable by these 

I I I microcomputers. 

+ + + 

(*a) To use clock frequencies above 6.0 MHz, the configuration 
switch in the prototype control probe's interface assembly 
must be set as prescribed in the 8048/8021 /804l A/8022 Emulator 
Processor and Prototype COntrol Probe Installation Service 
Manual . 

(*b) In emulation mode 1 with memory mapped to 8550 program 
memory, the clock frequency is divided by 2 to produce an 
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MEMORY MAPPING 

Figure 7H-3 illustrates the memory layouts for the microcomputers in the 
8048 family. You can access all three 8048/802 1/8041 A/8022 memory areas 
(program memory, internal data memory, and external data memory) using 
standard DOS/50 or OS/40 memory manipulation commands such as D, EX, F, 
LO, P, and SEA. 

NOTE 



In this Emulator Specifics section, the term program memory 
refers to the on-board ROM and/or external memory in which 
8048/802 1/8041 A/8022 program instructions are stored. The 
term 8550/8540 program memory refers to the RAM in the 8550 or 
8540 that may be used as a substitute for memory in the 
microcomputer and/or prototype. Throughout the other sections 
of your System Users Manual, the term program memory refers to 
8550 or 8540 program memory. 



Program Memory . The 8048 contains IK of on-board ROM, and the 8049 
contains 2K of on-board ROM. The 8048 and 8049 can each address 4K of 
external program memory. 

The 8021 and 8041A each contain IK of on=board ROM. The 8022 contains 
2K of on-board ROM. The 8021, 8041A, and 8022 cannot access external 
memory . 

The emulating microcomputer contains no on-board ROM. Program memory is 
emulated by bytes 0000 — OFFF of 8550/8540 program memory. For example, 
the Dump command D 3F displays bytes — 3F of program memory. 

For the 8048/8049 only, program memory can be mapped to the prototype. 
To run a program that resides in external program memory on the 
prototype, three conditions must be satisfied: 

• The prototype EA line (8048 input) must be asserted. 

• In mode 1 , the appropriate address ranges of program memory 
must be mapped to the prototype (MAP U). 

• The switch pack on the 8048/8021 prototype control probe 
assembly must be set to enable external program memory. For 
information on how to set the switch, refer to your 
8048/8021/8041 A/8022 Emulator Processor Installation Manual. 



NOTE 



DOS/50 and OS/40 cannot write to program memory on the 
prototype. For example, you cannot use the LO or MOV command 
to load instructions into program memory on the prototype. 
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Memory Area 


Internal 
Data Memory 


Krogram Memory 


External 
Data nnemory 


Corresponding 
Area of 8550" 
Program Memory 


4000— 403F 
4000-407F 


0000-OFFF 


2000-20FF 



8048/8049 



8021 



8022 



o 

7 


register 
bank 


18 
IF 




register 
bank 1 


3F/7F^ 





3F 



7FF 

FFF 




memory 
bank 



memory 
bank 1 



3FF 



3F 



7FF 



'3F for 8048; 7F for 8049 



FF 



8041 A 




7 

18 
IF 

3F 


register 
bank 



3FF 














register 
bank 1 











(3569-5)3967-2 



Fig. 7H-3. 8048/8021/8041A/8022 memory layout. 
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Internal Data Memory . The 8049 contains 128 bytes of internal RAM 
("internal data memory"). Each of the other microcomputers (the 8048, 
8021, 8041A, and 8022) contains 64 bytes of internal RAM. 

Although this RAM actually resides in the emulating microcomputer, it 
can be treated as if it occupied bytes 4000— 403F of 8550/8540 program 
memory (for the 8049, bytes 4000 — 407F.) For example, the command 
D 4000 4007 displays the contents of registers RO — R7, which occupy 
bytes — 7 of internal data memory. You can access the registers in 
internal data memory using the S (Set) command as well as the standard 
DOS/50 or OS/40 memory manipulation commands. 

NOTE 



To access 8550/8540 program memory in the range 4000 — 407F, 
first transfer the contents of locations 4000-407F to another 
area of 8550/8540 program memory: 

> MOV PP 4000 407F address <CR> (MOVe Program to Program), 

then use standard operating system commands. 

To transfer the contents of internal data memory to 8550/8540 
program memory, enter: 

> MOV UP 4000 407F address <CR> (MOVe User to Program). 



NOTE 



When any 8048-family microcomputer other than the 8049 is 
being emulated, bytes 4040 — 407F of internal data memory 
contain OFFH, and can only be accessed by the D command. 



Internal data memory cannot be mapped to the prototype. 

External Data Memory . Using the MOVX instruction, the 8048/8049 can 
address 256 bytes of external RAM. This external data memory is 
emulated by bytes 2000 — 20FF of 8550 or 8540 program memory. For 
example, the command D 2000 20FF displays the contents of external data 
memory. The command MAP U 2000 20FF maps all of external data memory to 
the prototype. 

The 8021, 8041 A, and 8022 cannot access external memory. 

NOTE 



To correctly emulate a microcomputer, restrict programming to 
within its memory limitations, as shown in Fig. 7H-4. Errors 
in loading or execution will result if your program attempts 
to access locations outside the appropriate memory areas. 
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Designating Memory Areas in Assembly Language Programs 

The DOS/50 or OS/40 LO command can be used to load data into all three 
8048/802 1/8041 A/8022 memory areas. To load a data item into internal 
data memory, locate the data item in the range 4000 — 403F (for the 8049, 
4000 — 407F) . To load a data item into external data memory, locate the 
data item in the range 2000 — 20FF. 



Modules That Do Mot Require Linking ^ To locate the data in the proper 
range, use ORG directives. In the following example, after the module 
is assembled and loaded, bytes 18 — IF of internal data memory are set to 
zero and bytes — 4 of external data memory contain the word "ERROR". 



ORG 


4018H 


BYTE 


0,0,0,0,0,0,0,0 


ORG 


2000H 


ASCII 


"ERROR" 


END 





INTERNAL DATA MEMORY LOCATION 18 
8 ZEROS 

EXTERNAL DATA MEMORY LOCATION 
5 LETTERS 



Modules That Must Be Linked Before Loading . Some modules must be linked 
before they are loaded. For example, program modules that use symbolic 
debug are linked in order to access symbols from the object file. In 
the following example, a new section is defined for each area of memory. 
The ORG directives are relative to the beginning of each section. Then, 
when you invoke either the A Series or B Series linker, include the 
LOCATE command option for each section. (The demonstration run program, 
later in this section, includes examples of linker usage.) 



SECTION INTERNAL 

ORG 18H 
FIRST BYTE 0,0,0,0,0,0,0,0 

SECTION EXTERNAL 

ORG OH 
NEXT ASCII "ERROR" 

LIST DBG 

END FIRST 



DEFINE THE INTERNAL MEMORY SECTION 
INTERNAL DATA MEMORY LOCATION 18 
8 ZEROS 

DEFINE THE EXTERNAL MEMORY SECTION 
EXTERNAL DATA MEMORY LOCATION 
5 LETTERS 



For more information about the linker, see your A 
Assembler Users Manual. 



Series or B Series 
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EMULATION MODES 

802 1/8041 A/8022 Emulation Modes 

Because the 8021, 8041 A, and 8022 have no external memory to map to the 
prototype, only emulation modes and 1 are available for these 
microcomputers. In mode 0, the emulator clock is used and program I/O 
is handled through service calls (SVCs). In mode 1, SVCs are disabled 
and the prototype's clock and I/O facilities are used. In both modes, 
8550/8540 program memory serves as a substitute for the microcomputer's 
program memory. 

8048/8049 Emulation Modes 

All three emulation modes are available for the 8048/8049: both program 
memory and external data memory can be mapped to the prototype in modes 
1 and 2. If a break occurs while the microcomputer is in an interrupt 
service routine, the IIP (interrupt in process) flag is not reset, and 
the microcomputer does not return from the interrupt. When the 
microcomputer is restarted after the break, the only way to return from 
the interrupt is to complete the interrupt service routine (or enter the 
RESET command). Otherwise, the microcomputer will not accept additional 
interrupts, and the IIP flag will remain set. 

When an interrupt and an instruction fetch on a breakpoint occur 
simultaneously, a false break line appears. The microcomputer performs 
the interrupt service routine, then returns and breaks. 

NOP— MOVX INSTRUCTION SEQUENCE 

Avoid using the NOP— MOVX conmiand sequence except to access byte of 
program memory. This design feature is described more fully under the 
heading "SVC Design Features" earlier in this section. 

Normally, the MOVX instruction is illegal for the 8021, 8041A, and 8022 
microcomputers. However, DOS/50 and OS/40 recognizes this MOVX sequence 
as valid for the specific purpose of accessing program memory location 
0. 

NOTE 



Be sure that you have specified TRA OFF before attempting to 
use MOVX for this purpose. 



TRA AND THE TIMER/COUNTER 

Be sure that TRAce is OFF before your program attempts to use the 
timer/counter. The timer/counter can interfere with the internal 
operations of DOS/50 or OS/40 when TRA selections are active. 
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8048/8049 SPECIAL CONSIDERATIONS 

Port Latch 

On an OUTL instruction, the 8048/8049 normally outputs data during S5 of 
the first cycle of the instruction. On ANL and ORL instructions, it 
outputs data during S4 of the second cycle. However, for all three 
instructions, the emulator outputs port data during S1 of the second 
cycle of the instruction. 

Port 2 Latch and External Program Memory Switch 

A switch in the 8048/8021 prototype control probe enables the emulating 
microcomputer to access external program memory. The status of this 
switch affects activity on pins P20 — P23, which output the four 
high-order bits of the program counter during instruction fetches to 
external program memory. 

When this switch is on, pins P20 — P23 behave as if external program 
memory is always being accessed, regardless of the value of the program 
counter and the state of the EA input. The address information on port 
2 will always be output; the I/O information on port 2 will unlatch 
during every memory access, then relatch on the leading (rising) edge of 
the subsequent ALE. When an IN P2,A instruction is executed and the 
switch is on, the emulator will sample the P20 — P23 pins regardless of 
whether they were previously programmed as "output." Any of the 
P20 — P23 lines that are not driven by the prototype will appear as ones 
in the accumulator. 

On an OUTL instruction, the 8048/8049 normally latches data during S5 of 
the first cycle of the instruction. On ANL and ORL instructions, it 
latches data during S4 of the second cycle. However, when the external 
program memory switch is off, the emulator latches P20 — P23 I/O data 
during S3 of the second cycle of the next instruction. 



8048/8021 Address Latch Enable (ALE) 

The emulating microcomputer in the 8048/8021 prototype control probe is 
an 8039 « The 8039 continuously issues the ALE signal to the prototype, 
even when it is executing 8550 of 8540 debug routines. The internal 
program addresses of these debug routines may be interspersed with your 
oroffram's addresses. 



Prototype Clock 

The 8048/8021 prototype control probe treats the XI clock pin as an 
input and the X2 pin as an output in order to drive a crystal circuit. 
However, Intel's revised specifications for the 8048, 8035, 8049, and 
8039 microcomputers require that both pins be driven if the clock source 
is an external TTL clock. Therefore, if your prototype uses an external 
TTL clock, the prototype X2 driver should be disconnected while using 
the emulator. 
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8021 SPECIAL CONSIDERATIONS 

8048/8021 Address Latch Enable (ALE) 

The emulating microcomputer in the 8048/8021 prototype control probe is 
an 8039. The 8039 continuously issues the ALE signal to the prototype, 
even when it is executing 8550 or 8540 debug routines. The internal 
program addresses of these debug routines may be interspersed with your 
program's addresses. 

JMP and CALL Instructions 

The 8021 is emulated by an 8039 microcomputer. The 8039 can address 2K 
of program memory, while the 8021 has only IK. Thus, whenever you use a 
JMP or CALL instruction with the 8021, the op code must be in the range 
04, 14, ..., 64, 74. For the 8021, the following op codes are illegal: 
84, 94, A4, B4, C4, D4, E4, and F4. If the emulator attempts to execute 
one of these illegal codes, no error indication will appear in your 
TRAce display; the program will simply halt. The only way to determine 
the cause of the halt is to inspect the op codes in your listing, 

8041 A SPECIAL CONSIDERATIONS 



JMP and CALL Instructions 

The 8041 A is emulated by an 8035 microcomputer. The 8035 can address 2K 
of program memory, while the 8041 A has only IK. Thus, whenever you use 
a JMP or CALL instruction with the 8041 A, the op code must be in the 
range 04, 14, ..., 64, 74. For the 8041A, the following op codes are 
illegal! 84, 94, A4, B4, C4, D4, E4, and F4. If the emulator attempts 
to execute one of these illegal codes, no error indication will appear 
in your TRAce display; the program will simply halt. The only way to 
determine the cause of the halt is to inspect the op codes in your 
listing. 



Input/Output Buffers 

The 8041 A has internal input/output buffers. On the 8041A prototype 
control probe, these buffers are located external to the emulating 8035 
microcomputer. Thus, the buffer contents can be altered even when the 
emulator is not active. In such cases, the buffer flags would be 
affected, and the DS display would not show the correct emulator status. 
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RETR Instruction 

In the 8041 A prototype control probe, the FO flag is placed on the FO 
flag stack by an interrupt, but not by a subroutine call. Therefore, 
use a RET instruction to return from a subroutine. Use a RETR 
instruction only to return from an interrupt service routine. 

8022 SPECIAL CONSIDERATIONS 



RETT Instruction 

The op code for the 8022 RETI instruction is 93H. However, the 
emulating 8035 microcomputer recognizes that op code as a RETR 
instruction. The 8035 RETR instruction performs three functions: 

• allows interrupts (if interrupts are enabled); 

• restores the program counter from the stack; 

• restores the program status word (PSW) from the stack. 

However, the 8022 RETI instruction only performs the first two 

functions. Thus, whenever your program includes a RETI instruction, the 

8035 will automatically restore the PSW. However, your prototype 8022 
will not restore the PSW. 

Also note that the 8022 RETI instruction increments the program counter, 
while the 8035 RETR instruction does not. Thus, the possibility exists 
that your program could execute the same instruction twice upon return 
from an interrupt. 

A-to-D Converter 

The 8022 requires that the analog input be maintained at a constant 
voltage during the sample time. A SEL ANO or SEL AN1 instruction 
changes the input voltage. Thus, the first RAD instruction after any 
SEL instruction will be inaccurate. Each succeeding RAD will be 
accurate. 



Pullup Options 

Two pullup options are available with the 8022. With the emulating 8035 
microcomputer, these options are selected by a cuttable run (T1) and by 
switch settings (Port 0) on the 8022 prototype control probe. Refer to 
your 8048/8021/8041 A/8022 Emulator Processor Installation Manual for 
information on how to set these pullup options. 
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The emulating microcomputer resides in the prototype control probe, and 
the signals between the prototype and the emulating microcomputer are 
buffered. Therefore, some timing differences exist between the 
8048/8021/8041 A/8022 emulator and a microcomputer inserted directly into 
the prototype. 

Table 7H-6 lists the probe/microcomputer timing differences for the 
8048/8021 prototype control probe. Figure 7H-4 contains timing diagrams 
corresponding to the signals listed in that table. 

Similarly, Tables 7H-7 and 7H-8 and Fig. 7H-5 give timing differences 
for the 8041 A prototype control probe. Table 7H-9 and Fig, 7H-6 give 
timing differences for the 8022 prototype control probe. 



Table 7H-6 
Probe/Prototype Interface Delays for the 8048/8021 











-+- 


t(PHL) (ns) 


-+- 


t(PLH) (ns) 


Signal 










Maximum 




Maximum 


ALE 










20 




20 


PSEN 










32 




32 


RD, WR 










26 




22 


PROG 










20 




20 


DBO— DB7 (*a) I 


t(1)- 


-fetch cycle 




90 




90 


(P00-P07) 1 


t(2)- 


-execute 


cycle 




38 




38 


Prototype to CPU 1 
















DBO— DB7 1 


t(3)- 


-address 


out 




38 




38 


(P00-P07) 1 


t(4)- 


-external 


data 




38 




38 


CPU to Prototype ! 




out 














t(5)- 


-OUTL, ANL, 




(»b) 




(»b) 






ORL data 


out 










+- 










-+- 





-+- 





P10— P17, P24— P27 










2 




2 


P20— P23 










(*c) 




(*c) 


TO (»d) out/ in 










15 




15 


T1 














182 


INT 










32 




32 


RST (t(PHL) for 8021, t(PLH) for 8048) 




284 




284 


SS 










32 




32 


CLK 










79 




79 



(*a) t(RD) = t(1,2) + tCprototype memory access) 

(*b) OUTL, ANL, and ORL bus I/O information is latched during SI 

of the second cycle of the instruction. 
(*c) When external program memory is enabled (by a DIP switch in the 

prototype control probe), the maximum address delay is 32 ns. 

When external program memory is disabled, OUTL, ANL, and ORL 

information is latched during the S3 cycle following the next 

instruction fetch. 
(*d) If the prototype clock frequency is greater than 6 MHz and 

memory is mapped to the 8550 or 8540, TO out is divided by 2. 
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Fig. 7H-4. 8048/8021 timing diagrams. 

These timing diagrams illustrate the signals described in 
Table TH-6. For signals sent from the CPU to the prototype, 
solid lines represent timing at the CPU and dashed lines 
represent timing seen by the prototype. For signals sent from 
the prototype to the CPU, solid lines represent timing at the 
prototype and dashed lines represent timing seen by the CPU. 
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Table 7H-7 
Probe/Prototype Interface Delays for the 8041A 





-+ 

1 t(PHL) ( 


ns) 


-+ 

1 t(PLH) (ns) 


Signal 


1 Maximum 




1 Maximum 


SYNC 


1 20 




1 20 


PROG 


1 20 




1 20 


T1 






1 39 


P10— P17 


1 2 




1 2 


TO 


1 45 




1 34 



Table 7H-8 
Representative 8041 A Probe/8041 A Microcomputer Timing Differences 







Microcomputer 


Probe 






Symbol 


Parameter 


Min. 


Max. 


Min. 


Max. 


Units 


t(ACC) 


DACK fall to WR or RD 







54 




ns 


t(CAC) 


RD or WR to DACK rise 







71 




ns 


t(ACD) 


DACK fall to data valid 




225 




225 


ns 


t(CRQ) 


RD or WR to DRQ cleared 




200 




200 


ns 


t(AW) 


CS, AO setup to WR fall 












ns 


t(WA) 


CS, AO hold after WR fall 







24 




ns 


t(WW) 


WR pulse width 


250 




250 




ns 


t(DW) 


Data setup to WR rise 


150 




150 




ns 


t(WD) 


Data hold after WR rise 







70 




ns 



Timing assumptions: CPU timing reference is Intel Peripheral Design 
Handbook, published by Intel Corp., 1979. 
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INTERFACE DELAYS 
SYNC 
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Fig. 7H-5. 8041 A timing diagrams. 

These timing diagrams illustrate the signals described in 
Tables 7H-7 and 7H-8. Dashed lines represent signal delays 
between the CPU and the prototype. 
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Table 7H-9 
Probe/Prototype Interface Delays for the 8022 







-+- 


t(PLH) 


-+- 


t(PHL) 


-+ 

1 




Signal 






Maximum 




Maximum 


1 


Units 


ALE 






34 




46 


1 


ns 


POO— P07 


CPU to prototype 




87 




91 


1 


ns 


POO— P07 


prototype to CPU 




1.3 




1.3 


1 


us 


P10— P17 


! t(1) CPU to 

1 prototype 




2 




2 


1 
1 


ns 




1 t(2) prototype 




2 




2 


1 


ns 




1 to CPU 










1 




P20— P23 


1 t(3) A to P2 




18 




24 


1 


ns 


(*a, »b) 


1 t(4) P2 to A 




18 




24 


1 


ns 


PROG 






18 




24 


1 
1 


ns 


TO 






24 




24 


1 


ns 


T1 






182 




182 


1 


ns 


ANO, AN1 


(»c) 




444 




444 


1 


ns 


XTAL1 






33 




45 


1 


ns 


RESET 






229 




229 


1 


ns 



(*^\ 



Inputs must be present until read by an input 



instruction (Intel Specification). 
(*b) For OUTL, ORL, and ANL instructions, data will be 

valid before ALE following the next instruction fetch, 
(*c) Input capacitance: 37 pf maximum. 
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These timing diagrams illustrate the signals described in 
Table 7H-9. Dashed lines represent signal delays between the 
CPU and the prototype. 
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Figures 7H-7, 7H-8, and 7H-9 are block diagrams of the probe/prototype 
interfaces for the 8048/8021, 8041A, and 8022 prototype control probes, 
respectively. 
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Fig. 7H-7. Block diagram of 8048/8021 probe/prototype interface. 

This figure provides a functional overview of signal buffering 
between the prototype and the emulating microcomputer on the 
8048/8021 prototype control probe. A more detailed circuit 
description can be found in the 8048/8021/8041 A/8022 Emulator 
Service Manual. 
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Fig. 7H-8. Block diagram of 8041A probe/prototype interface. 

This figure provides a functional overview of signal buffering 
between the prototype and the emulating microcomputer on the 
8041A prototype control probe, A more detailed circuit 
description can be found in the 8048/8021/8041 A/8022 Emulator 
Service Manual, 
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Fig. 7H-9. Block diagram of 8022 probe/prototype interface. 

This figure provides a functional overview of signal buffering 
between the prototype and the emulating microcomputer on the 
8022 prototype control probe. A more detailed circuit 
description can be found in the 8048/8021 /804l A/8022 Emulator 
Service Manual. 
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INSTALLING YOUR 8048/8021 /804l A/8022 EMULATOR SOFTWARE 

8540 FIRMWARE INSTALLATION PROCEDURE 

The ROMs that contain the control software for your 8048/8021/8041 A/ 
8022 emulator must be installed in your 8540 's System ROM Board. Refer 
to your Emulator Installation Manual for instructions on installing 
these ROMs. 

8550 INSTALLATION PROCEDURE 

This subsection describes how to install the control software for your 
8048/8021/8041A/8022 emulator. To complete this installation procedure, 
you need the following items: 

• an 8550 system (with or without an 8048/8021/8041 A/8022 emulator) 

• a DOS/ 50 system disk with a write-enable tab over the write-protect 
slot 

• an 8048/8021/8041 A/8022 emulator software installation disk with no 
write-enable tab. 

This procedure takes about five minutes. 



Start up and Set the Date 

Turn on your 8550 system. (For start-up instructions, refer to the 
paragraph "Start Up the 8550 and Its Peripherals" in the Learning Guide 
section of your System Users Manual.) Place your system disk in disk 
drive and shut the drive door. When you see the > prompt on your 
system terminal, place your installation disk in disk drive 1 and shut 
the drive 1 door. 

Use the DAT command to set the date and time. For example, if it is 
11:05 am on April 1, 1983, type: 

> DAT OI-APR-83/ 11:05 <CR> 

The system will use this information when it sets the Creation Time 
attribute of each file copied frcxn your installation disk. 

Install the Software 

The command file INSTALL?; which is used to install the software, 
resides on the installation disk. 

NOTE 

If your system disk contains DOS/50 Version 2> use the command 
file INSTALL instead of INSTALL2. 

To execute this command file, type its filespec: 

> /VOL/EMU. 8048/INSTALL2 <CR> 
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DOS/50 responds with the following message: 

* During this installation procedure, one or more of the 

* following messages may appear. IGNORE THESE MESSAGES: 

* Error 6E - Directory alteration invalid 

* Error 7E - Error in command execution 

* Error ID - File not found 

« 

* If any OTHER error message appears, see your 

* Users Manual for further instructions. 
» 

* If no other error message appears, you'll receive a 

* message when the installation procedure is complete. 

T,OFF 

In the installation process, you may disregard error messages 6E, 7E, 
and ID; these messages have no bearing on the success of the 
installation. However, if a message other than 6E, 7E, or ID appears, 
take the following steps: 

1. Make sure you are using the right disks. 

2. Make sure your system disk has a write-enable tab. 

3. Make sure there are at least 3 free files and 20 free 
blocks on your system disk. 

4. Begin the installation procedure again. 

If the installation procedure fails again, copy down the error message 
and contact your Tektronix service representative. 

The "T,OFF" command suppresses subsequent output to your system terminal 
(except error messages) until INSTALL2 finishes executing. Within about 
five minutes, INSTALL2 will finish and your system terminal will display 
the following message: 

« 

* Your installation has been successfully completed. 
> 

Once your software is installed, you can: 

• remove your disks and turn off your 8550 system, or 

• install more software, or 

• continue with the 8048/802 1/8041 A/8022 Emulator Demonstration 
Run that follows in this section. If you do this, you do not 
have to restart the system or reset the date and time. 

NOTE 

At this point, "NO. NAME" is the current user. To change the 
current user back to "yourname", enter USER , , yourname . 
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INTRODUCTION 



This Demonstration Run shows you how to assemble, load, execute, and 
monitor a simple 8048 assembly language program on your 8540 or 8550. 
This program can be executed using any prototype control probe that is 






In ordcx- to pex'f Oi'ui 



this demonstration, your 8048/8021/8041 A/8022 emulator, prototype 
control probe- and control software must be installed in your 8540 or 



8550. 

Figure 7H-10 shows the source and object 
program. If you have an 8550, the 
source code and object code for the 
demonstration program are provided on 
the installation disk that contains your 
8048/8021/8041A/8022 emulator control 
software. This demonstration shows you 
how to assemble the program on your 
8550. (If your system disk does not 
contain a 8048/8021 /8041A/8022 
assembler, you will have to skip that 
part of the demonstration.) 

If you have an 8540/8560 system and your 
8560 has a 8048/8021/8041A/8022 
assembler installed, you can create and 
assemble the program on the 8560 and 
then download it to the 8540. This 
demonstration shows how. 

If you have an 8540 that is connected to 
a host computer other than an 8560, we 
can't give you a specific list of 
commands for creating and assembling the 
program on your host (since we don*t 
know what host you're using). However, 
Fig. 7H-11 gives the object code for 
the program in Extended Tekhex format. 
You can create the Tekhex file using 
your host's assembler or text editor, 
and then download the file to the 8540 
via the 8540 's optional COM interface^ 

If none of these cases applies to you, 
you can patch the program into memory ^ase 4: 
P command. This demonstration 



using the P command 
shows how 



code for the demonstration 



Case 1 : 




8540 + 8560 



Case 3: 





8540 + other host 



any other configuration 



(3964-5)3967-9 



Once the program is loaded or patched into memory, you can 
program on your emulator. 



execute the 
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NOTE 



The 8540 commands shown in this demonstration can also be used 
for an 8550 that is connected to an 8560 or other host 
computer. 



01 






;8048 


DEMONSTRATION RUN ] 


PROGRAM 


02 








SECTION DEMO 




03 


000100 






ORG 


100H 


; START PROGRAM CODE AT ADDRESS 100 


04 


000100 


B932 


START 


MOV 


R1,#TABLE 


;SET TABLE POINTER 


05 


000102 


BF05 




MOV 


R7,#TSIZE 


;SET PASS COUNTER 


06 


000104 


27 




CLR 


A 


; CLEAR ACCUMULATOR 


07 


000105 


61 


LOOP 


ADD 


A,@R1 


;ADD BYTE FROM TABLE 


08 


000106 


19 




INC 


R1 


; POINT TO NEXT BYTE 


09 


000107 


EF05 




DJNZ 


R7,L00P 


; DECREMENT PASS COUNTER AND 


10 












; LOOP IF NOT FIVE PASSES YET 


11 


000109 


AA 




MOV 


R2,A 


; OTHERWISE SAVE SUM IN R2 


12 


000 10A 


23F7 




MOV 


A,#0F7H 


; AND CALL EXIT SVC 


13 


00010c 


00 




NOP 




; TO END PROGRAM EXECUTION 


14 


00010D 


A3 




MOVP 


A,@A 




15 


00010E 


00 




NOP 






16 






;SRB POINTER 






17 




0040 




ORG 


40H 


; STORE SRB POINTER AT ADDRESS 40 


18 


000040 


0042 




BYTE 


00,42H 


; POINT TO SRB FOR EXIT SVC 


19 






;SRB FOR EXIT 


SVC 




20 


000042 


1A 




BYTE 


1AH 


;1AH = FUNCTION CODE FOR EXIT SVC 


21 






; TABLE 


: OF NUMBERS TO BE ADDED 


22 






TSIZE 


EQU 


5 


; TABLE SIZE = 5 


23 








SECTION INTERNAL 


; SECTION FOR INTERNAL DATA MEMORY 


24 








ORG 


32H 


;SET UP TABLE AT ADDRESS 32 


25 






TABLE 


BLOCK 


TSIZE 




26 








LIST 


DBG 




27 


1 

1 

1 

1 
1 


1 
1 
1 
+ — 


object 


END 

1 
source 

code 


START 
code 


1 
comments 




1 
+ — 




address 






> 






source 


*^nH*a 1 1 1^0 niimK^y* 




T~" 






i^^ViC X JL 




3967-12 



Fig. 7H-10. Demonstration program. 



REV SEP 1983 



7H-37 



8048 Demonstration Run 8048 Emulator Specifics Users 



(A) $276033 1 00B932BF05276 1 19EF05AA23F700A300 
$0E62B24000421A 

56393464DEMO010350514LOOP310515START310015TABLE23225TSIZE15 
$23331 8INTERNAL04400023715TABLE44032 






(B) FIRST DATA BLOCK: object code for addresses 100— 10E 

header load address object code 
I I ! 

$276C33100B932BF05276119EF05AA23F700A300 



SECOND DATA BLOCK: object code for addresses 40—42 

header load object 
I address code 
I ! I 

$0E62B24000421A 



FIRST SYMBOL BLOCK 

section 
header section definition 

I name field symbol definition fields 



$393464DEMO0103505l4LOOP310515START310015TABLE23225TSIZE15 



SECOND SYMBOL BLOCK 

section symbol 

header section definition definition 

I name field field 



$233318INTERNAL04400023715TABLE44032 
TERMINATION BLOCK 

V/1 CLXilSJi C^l 

address 



$098153100 



Fig. 7H-11. Demonstration program: Extended Tekhex format. 

Figure 7H-11A shows an Extended Tekhex load module that 
contains the object code and program symbols for the 
demonstration program. Figure 7H-11B labels the different 
fields in the message blocks. If you have a host computer 
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other than an 856O, you can create this load module and 
dovmload it to your 8540 or 8550. 



EXAMINE THE DEMONSTRATION RUN PROGRAM 

The demonstration run program adds five numbers from a table stored in 
8048 internal data memory locations 32 — 36 and leaves the sum in 
register R2. (You will place values in the table later in this 
demonstration.) The 8085A emulator demonstration run in the Learning 
Guide section of your System Users Manual contains a flowchart that 
illustrates the steps of the program. 

The source code contains two kinds of statements: assembler directives 
(such as ORG and BYTE) and 8048 assembly language instructions. The 
assembler directives are microprocessor-independent and are explained in 
the 8O85A emulator demonstration run. The 8048 assembly language 
instructions are discussed in the following paragraphs. 



Set Table Pointer . The MOV R1, STABLE instruction loads the lower byte of 
the address of the table (4032) from internal data memory into register 
R1. As a result, R1 points to the first element of the table. The 
label START is used by the END directive to specify that the 
MOV R1,#TABLE instruction is the first to be executed. 



Set Pass Counter . Register R7 is used as the pass counter. The 
MOV R7,#TSIZE instruction moves the value of TSIZE into R7. This step 
sets the number of passes to 5. Each time a number is taken from the 
table and added into the accumulator, R7 is decremented. 



Clear Accumulator . The CLR A instruction zeros the accumulator so that 
you can start adding numbers from the table. 



Add Byte From Table . The ADD A,§R1 instruction adds the byte addressed 
by R1 into the accumulator. The label LOOP represents the address of 
this instruction; this label is used by the DJNZ instruction. 



Point to Next Byte . The INC R1 instruction increments R1; this register 
then points to the next byte in the table. For example, R1 is 
initialized to contain 32. After the INC R1 instruction is first 
executed, R1 will contain 33 > the address of the second element of the 
table. 



Decrement Pass Counter and Loop If Not Five Passes Yet . The DJNZ R7,L00P 
instruction decrements R7, the pass counter. In this program, R7 is 
decremented each time a number is added to the accumulator. If R7 does 
not contain zero after being decremented, the program jumps back to the 
LOOP label. If R7 contains zero, the program proceeds to the next 
instruction, MOV R2,A. 
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Save Sum in R2 . After all five numbers have been added together, the 
MOV R2,A instruction moves the sum from the accumulator into register 
R2. The sum must be saved in R2 because the accumulator is used by the 
service call that follows. 



Exit . The last four instructions of the program are: 
MOV A,#0F7H 

Mr\n 

MOVP A,@A 
NOP 

These instructions constitute a service call (SVC) that causes an exit 
from the program. For more information on SVCs, refer to the Service 
Calls discussion in this Emulator Specifics section. 

ASSEMBLE AND LOAD THE DEMONSTRATION PROGRAM 

Now it's time to create the program so you can run it on your emulator. 
One of the following discussions describes the set of steps that is 
appropriate for your hardware configuration: 

• For 8550 users — Case 1 : Assemble and Load on the 8550 

• For 8540/8560 users — Case 2: Assemble on the 856O; Download 
to the 8540 

• For 8540 users with a host computer other than the 8560 — Case 
3: Download from Your Host to the 8540 

• For other hardware configurations — Case 4: Patch the Program 
into Memory 

Go ahead and work through the discussion that's appropriate for you. 
Once you've put the program into 8550/8540 program memory, turn to the 
heading "Run the DeiBonstr-ation Program," later in this section. 
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CASE 1: ASSEMBLE AND LOAD ON THE 8550 

This discussion shows you how to copy the demonstration program from 
your 8048/802 1/8041 A/8022 emulator software installation disk, assemble 
the program, and load it into 8550 program memory. 



Start Up and Log On 

Turn on your 8550 system. (For start-up instructions, refer to the 
paragraph "Start Up the 8550 and Its Peripherals" in the Learning Guide 
section of your System Users Manual.) Place your system disk in disk 
drive and shut the drive door. When you see the > prcxnpt on your 
system terminal, place your installation disk in disk drive 1 and shut 
the drive 1 door. 

Use the DAT command to set the date and time. For example, if it is 
2:35 pm on April 1, 1983, type: 

> DAT 01-APR-83/2;35 pm <CR> 

Use the SEL command to tell DOS/50 to use the assembler and emulator 
software designed for the 8048 family: 

> SEL 8048 <CR> 

The SEL command automatically sets the emulation mode to 0. 



Copy the Demonstration Run Program from the Installation Disk 

Enter the following command lines to create an empty directory called 
DEMO on your system disk and make DEMO the current directory. The BR 
command creates a brief name, ROOT, to mark the old current directory. 
At the end of this demonstration, you will return to this ROOT directory 
and delete the DEMO directory and its contents. 

> BR ROOT /USR <CR> 

> CREATE DEMO <CR> 

> USER DEMO <CR> 

Now use the COP command to copy all the files in the DEM02 directory on 
the installation disk to the DE^© directory you just created: 

> COP /VOL /EMU. 8048 /DEM02/* » <CR> 

Remove your installation disk from drive 1 and put it away. 

Now list the files you have just copied to the current directory: 
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ASM 
LOAD 

Files used 
Free files 

r ICC uxt^vjiivo 

Bad blocks 



96 
160 



The file named ASM contains the assembly language source code for the 
demonstration program, and the file named LOAD contains the executable 
object code. This copy of LOAD will be used in the demonstration only 
if you do not have an 8048/8021/8041 A/8022 assembler (and thus cannot 
create your own object file and load file from the source file.) 



Examine the Demonstration Program 

Enter the following command line to display the source file ASM 
system terminal: 

> CON ASM <CR> 

;8048 DEMONSTRATION RUN PROGRAM 
SECTION DEMO 



on the 



ORG 
START MOV 
MOV 
CLR 
LOOP ADD 
INC 
DJNZ 



100H 

R1,#TABLE 

R7,#TSIZE 

A 

A,§R1 

R1 

R7,L00P 



R2,A 
A,#0F7H 

A,§A 



40H 
00.42H 



START PROGRAM CODE AT ADDRESS 100 

SET TABLE POINTER 

SET PASS COUNTER 

CLEAR ACCUMULATOR 

ADD BYTE FROM TABLE 

POINT TO NEXT BYTE 

DECREMENT PASS COUNTER AND 
LOOP IF NOT FIVE PASSES YET 

OTHERWISE SAVE SUM IN R2 
AND CALL EXIT SVC 
TO END PROGRAM EXECUTION 



MOV 

MOV 

NOP 

MOVP 

NOP 
;SRB POINTER 

ORG 

BYTE 
;SRB FOR EXIT SVC 

BYTE 1AH 
•.TABLE OF NUMBERS TO BE ADDED 
TSIZE EQU 5 ; TABLE SIZE = 5 

SECTION INTERNAL 

ORG 32H ;SET UP TABLE AT ADDRESS 32 
TABLE BLOCK TSIZE 

LIST DBG 

END START ;END OF SOURCE CODE 



; STORE SRB POINTER AT ADDRESS 40 
! POINT TO SRB FOR EXIT SVC 

;1AH = FUNCTION CODE FOR EXIT SVC 
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Assemble the Source Code 

If you do not have a 8048/8021/804lA/8022 assembler on your system disk, 
you cannot perform this step, so skip the next four commands (ASM, COP, 
LINK, and L.) 

The ASM (assemble) command translates assembly language (source code) 
into binary machine language (object code). The ASM command also 
creates an assembler listing that can be used to correlate the object 
code with the source code. Enter the following command line to assemble 
the source code in the file ASM and create the listing and object files 
ASML and OBJ: 

> ASM OBJ ASML ASM <CR> 



+ — source file 
assembler listing file 



+ object file 

Tektronix 8048 ASM Vx.x 
»»»» Pass 2 

26 Source Lines 26 Assembled Lines xxxxx Bytes Available 
>» No assembly errors detected <« 

Enter the following command to copy the assembler listing onto the line 
printer. (First, make sure the printer is turned on and properly 
connected.) 

> COP ASML LPT <CR> 

The different fields of your source listing are presented in Fig. 
7H-10, earlier in this demonstration. For a detailed explanation of 
assembler listings, consult your Assembler Users Manual. 



Link the Object Code . The linker creates an executable load file from 
one or more object files. Enter the LINK command to invoke the linker: 

> LINK <CR> 
8550 LINKER Vx.x 
» 

Now enter the following linker commands to create a load file called 
LOAD from your object file, OBJ: 

» LINK OBJ <CR> 

« LOAD LOAD <CR> 

* LOCATE INTERNAL, BASE (4000H) <CR> 

»DEBUG <CR> 

»END <CR> 
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The linker commands LINK and LO specify the object file and load file, 
respectively. The LOCATE command establishes the base address for 
section INTERNAL. The DEBUG command causes the linker to pass the 
program symbols from the object file along to the load file, for use in 
program debugging. After you enter the END command, the linker executes 
the commands you have entered, and the following information is 
displayed; 

TRUNCATION ERROR AT 0101 IN MODULE »NONAME* 
FILE OBJ 

2 ERRORS NO UNDEFINED SYMBOLS 
1 MODULE 2 SECTIONS 
TRANSFER ADDRESS IS 0100 

NOTE 



Because the instruction MOV R1,#TABLE is a two-byte 
instruction, the linker truncates 4032 to 32, and displays an 
error message. Ignore this truncation error message. 



The files generated by the ASM and LINK consnands should now be on your 
disk. Enter the following command to list the files in your current 
directory: 



> L <CR> 




FILENAME 




ASM 




LOAD 




OBJ 




ASML 




Files used 


126 


Free files 


130 


Free blocks 


811 


Bad blocks 






Notice that there are now four files listed in your directory. OBJ and 
ASML were created by the assembler, and LOAD was created by the linker. 
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Load the Program into Memory 

Now it's time to load the object code from the load file LOAD into 
program memory. 



Zero Out Memory . Before you load any code, use the F (Fill) command to 

fill 8550/8540 program memory with zeros. Later, when you examine 

memory, the zeros make it easy to identify the beginning and end of your 

code. (Zeroing out memory has no effect on how the program is loaded.) 

Enter the following command line to fill memory from address 40 through 
address 11F with zeros: 

> F 40 11F 00 <CR> 



Check That Memory Was Filled with Zeros . Check the contents of memory 

with the D (Dump) command. The D command's display shows the data in 
hexadecimal format, and also shows the corresponding ASCII characters. 

Display the contents of memory addresses 40 — 11F with the following 
command line: 

> D 40 11F <CR> 

0123456789ABCDEF 

000040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 , 

000050 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 , 

000060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 , 

000070 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000090 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOAO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOBO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOCO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOODO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOEO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOFO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000110 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 



Load the Object Code into Memory . Enter the following command line to 
load the object code for the demonstration program into program memory: 

> LO <LOAD <CR> 



load file 
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Load the Program Symbols . Recall that the source code for the 
demonstration program contained the directive LIST DBG. Because of this 
directive, the object file contains a list of the symbols that appeared 
in the source code, and the values associated with those symbols. 
Because you included the DEBUG command when you invoked the linker, 
those symbols were passed to the load file. Use the SYMLO command to 
load those symbols into the symbol table in 8550 system memory. 

> SYMLO =S <LOAD <CR> 

The -S option means that both addresses and scalars are loaded. If you 
omit the -S, only addresses are loaded. (A scalar is a number that is 
not an address for example, TSIZE, the length of the table.) 

Later in this demonstration, whenever you use a symbol in a command 
line, the operating system refers to the symbol table to find the value 
that the symbol represents. 

You've assembled and linked the demonstration program and loaded it into 
memory. Now skip ahead to the heading "Run the Demonstration Program." 
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CASE 2: ASSEMBLE ON THE 8560; DOWNLOAD TO THE 8540 

This discussion shows you how to create the demonstration program source 
code and assemble it on the 8560, then download it to 8540 (or 8550) 
program memory. If your 8560 does not have an 8048/8021/8041 A/8022 
assembler, you cannot complete this part of the demonstration, so skip 
ahead to the heading "Case 4: Patch the Program into Memory" for 
instructions. 

Start Up and Log In 

Start up your 8540, make sure it's in TERM mode, and log in to the 856O 
operating system, TNIX. See your 856O System Users Manual for details. 

Since you're logged in to TNIX, your system prompt is "$". (Later in 
the demonstration, we'll show the system prompt as ">", in deference to 
people using 8540s and 8550s in LOCAL mode.) Every command you enter is 
processed by TNIX. If you enter an OS/40 command, TNIX passes it to the 
8540. 

Enter the following command to select the 8048 assembler on the 856O and 
the 8048 emulator on the 8540: 

$ sel 8048 <CR> 

$ uP=8048; export uP <CR> 

The sel command automaticallv sets the emulation mode to 0. 



Create the Demonstration Program 

Enter the following TNIX command lines to create an empty directory 
called demo and make demo the working directory. You'll create your 
source file and related files in this demo directory. 

$ mkdir demo <CR> 
$ cd demo <CR> 

Now use the TNIX editor, ed, to create the demonstration program source 
file. The following command line invokes the editor and specifies that 
you want to create a file called asm: 

$ ed asm <CR> 
?asm 

The editor responds "?asm" to remind you that asm does not already 
exist. Notice that the editor does not give a prompt to let you know 
it's ready for input. 
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Enter the Text . Now enter the editor command a (append text) and type in 
the program. Use the BACKSPACE key to erase typing mistakes. 



<CR> 

column 
8 



column 
16 



column 
26 



V V V 

;8048 DEMONSTRATION RUN PROGRAM <CR> 

SECTION DEMO <CR> 

ORG 100H ; START PROGRAM CODE AT ADDRESS 100 <CR> 



START MOV 



R1,#TABLE 



MOV 



R7,#TSIZE 



CLR 



LOOP ADD 



A,@R1 



INC 



R1 



DJNZ R7,L00P 



MOV 



R2,A 



MOV 



A,#0F7H 



SET TABLE POINTER <CR> 



SET PASS COUNTER <CR> 



CLEAR ACCUMULATOR <CR> 



ADD BYTE FROM TABLE <CR> 



POINT TO NEXT BYTE <CR> 



DECREMENT PASS COUNTER AND <CR> 



LOOP IF NOT FIVE PASSES YET <CR> 



OTHERWISE SAVE SUM IN R2 <CR> 



AND CALL EXIT SVC <CR> 



NOP 



TO END PROGRAM EXECUTION <CR> 



MOVP A,@A <CR> 



NOP <CR> 



;SRB POINTER <CR> 



npn 



linu 



jKjj.\ji\i:i onij> IT v/xiMJ iziA ftx tti/i/n£iOO MU sun/' 



BYTE 00,42H ; POINT TO SRB FOR EXIT SVC <CR> 



;SRB FOR EXIT SVC <CR> 



BYTE 



1AH 



;1AH = FUNCTION CODE FOR EXIT SVC <CR> 



; TABLE OF NUMBERS TO BE ADDED <CR> 

TSIZE EQU 5 ; TABLE SIZE = 5 <CR> 

SECTION INTERNAL <CR> 

;SET UP TABLE AT ADDRESS 32 <CR> 



ORG 



32H 



TABLE BLOCK 



LiXOx 



END 



TSIZE <CR> 

DBG <CR> 

START ;END OF SOURCE CODE <CR> 



<CR> 



At the end of your text, enter a period on a line by itself, 
will go back to accepting commands. 



The editor 



Check for Errors . Enter the following editor command to display the text 
you have entered. Check for typing mistakes. 

1,$p <CR> 



II 

1+ — print command: displays the lines 

I in the designated range 

I 

+ designates last line in file 



designates first line in file 



If you made any mistakes, go ahead and fix them. In case you're not 
familiar with ed. Table 7H-10 lists the commands you need in order to 
add, delete, or replace any line. For more information on ed, refer to 
your 8560 System Users Manual. 
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Table 7H-10 
Basic 8560 Editing Commands 

+ 

Command | Function 

mm,nnp <CR> | Displays lines mm through nn 

+ 

nn <CR> i Makes line nn the current line 

+ 

d <CR> I Deletes the current line 

. + 

a <CR> I Adds text after the current line 

<line(s) of text> I 
. <CR> 1 

c <CR> I Replaces the current line with the 

<line(s) of text> I text you type in 
. <CR> I 

■ — + 

Once your text is correct, enter the w command to write the text to the 
source file, asm: 

w <CR> 

778 

The editor responds with the number of characters it wrote to the file. 
Finally, enter the £ command to quit the editor and return to TNIX: 



£ <CR> 

$ < TNIX prompt 



Assemble the Source Code . 

The TNIX asm (assemble) command translates assembly language (source 
code) into binary machine language (object code). The asm command also 
creates an assembler listing which can be used to correlate the object 
code with the source code. Enter the following command line to assemble 
the source code in the file asm and create the listing and object files 
asml and obj ; 

$ asm obj asml asm <CR> 



+ — source file 
assembler listing file 



+ object file 

ASM MCS 8048 Vxx.xx-xx Copyright 198x Tektronix, Inc. 
»»»»»Pass 2 

27 Lines Read 

27 Lines Processed 

Errors 
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Enter the following command to print the assembler listing on the 8560 's 
line printer: 

$ Ipir asml <CR> 

Check page 1 of your listing. Did the assembler issue any error 
messages? There should be none. If your source code contains errors, 
take the following steps: 

1 . Refer to your Assembler Users Manual to find out what the 
error messages mean. 

2. Enter the command ed asm to get back into the editor and 
fix the mistakes in your source code. Exit the editor with 
the w and q commands, as before. 

3. Enter the command asm obj asml asm to re-assemble your 
source code. 



Link the Object Code 

The linker creates an executable load file from one or more object 
files. Enter the following command to create a load file called load 
from your object file, obj . Be sure to capitalize all parameters as 
shown . 

$ link -d -0 obj -o load -m prog=0-120h -m int=4000-4037h -L sec=DEMO 
range prog -L sec=INTERNAL range int <CR> 

NOTE 



To simplify your task, you may want to create a linker command 
file to hold the command options. To do so, invoke ed, and 
place each command option on a separate line. Then, to 
execute the command file, you would enter: 
$ link -c commandfilename. 



The 22. option causes the linker to pass the program symbols from the 
object file to the load file, for use in program debugging. The -m 
option defines the memory map. In this case, the areas mapped are in 
program memory and internal data memory. The ^ option locates the two 
sections DEMO and INTERNAL. 

The linker responds with the following truncation error message. The 
truncation errors are caused by the MOV R1,#TABLE and DJNZ R7,L00P 
instructions. These instructions each expect an 8-bit operand. You may 
ignore these messages. 



link: 115 (E) Truncation error at 101 
link: 115 (E) Truncation error at 108 
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The files generated by the asm and link commands should now be in your 
working directory, demo. Enter the following command to list the files 
in your working directory: 

$ Is <CR> 

asm 

asml 

load 

obj 

Notice that there are now four files listed in your directory, obj and 
asml were created by the assembler, and load was created by the linker. 



Download the Program to the 8540 

Now it's time to download the object code produced by the 8560' s linker 
into 8540 program memory. 



Zero Out Memory . Before you download any code, use the OS/40 F (Fill) 

command to fill 8540 program memory with zeros. Later, when you examine 

memory, the zeros make it easy to identify the beginning and end of your 

code. (Zeroing out memory has no effect on how the program is loaded.) 

Enter the following command line to fill memory from address 40 through 
address 11F with zeros: 

$ f 40 1 1f 00 <CR> 



Check That Memory Was Filled with Zeros . Check the contents of memory 
with the OS/40 D (Dump) command. The D command's display shows the data 
in hexadecimal format, and also shows the corresponding ASCII 
characters. Display the contents of memory addresses 40 — 11F with the 
following command line: 

$ d 40 11f <CR> 

0123456789ABCDEF 

000040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000050 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000070 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000090 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOAO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOBO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOCO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOODO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOEO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOFO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000110 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
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Download the Object Code . Enter the following command line to download 
the object code from the 8560 file load to 8540 program memory: 

* lo <load <CR> 



load rile 



Download the Program Symbols . Recall that the source code for the 
demonstration program contains the directive LIST DBG. Because of this 
directive, the object file contains a list of the symbols that appear in 
the source code, and the values associated with those symbols. Because 
you included the -d option in the link command line, those symbols were 
passed to the load file. Use the OS/40 SYMLO command to download those 
symbols into the symbol table in 8540 system memory. 

$ symlo -s <load <CR> 

The -S option means that both addresses and scalars are downloaded. If 
you omit the -S, only addresses are downloaded. (A scalar is a number 
that is not an address for example, TSIZE, the length of the table.) 

Later in this demonstration, whenever you use a symbol in an 03/40 
command line, OS/40 refers to the symbol table to find the value that 
the symbol stands for. 

You*ve assembled and linked the demonstration program and downloaded it 
into memory. Now skip ahead to the heading "Run the Demonstration 
Program." 
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CASE 3: DOWNLOAD FROM YOUR HOST TO THE 8540 

This discussion gives some general instructions for downloading the 
demonstration program from an unspecified host computer to 8540 (or 
8550) program memory. If your 8540 is not equipped with the optional 
COM Interface Package, you cannot complete this part of the 
demonstration, so skip ahead to the heading "Case 4: Patch the Program 
into Memory" for instructions. COM Interface software is standard on 
the 8550. 

Since we don't know what host computer you're using, we can only provide 
a general outline for creating the demonstration program and downloading 
it to the 8540. Once you have determined the command sequence that is 
appropriate for your host, record this information in the space provided 
in Fig. 7H-12. 

Create the Extended Tekhex Load Module 

In order for the object code to be downloaded to the 8540, it must be in 
Extended Tekhex format, as shown in Fig. 7H-11, earlier in this 
demonstration. You can create the load module in one of two ways: 

1. Use your host computer's text editor, and key the load 
module in by hand. 

2. Use your host computer's 8048 assembler: 

a. Translate the demonstration program into the 
language of your host's 8048 assembler. 

b. Create and assemble the source file. 

c. Link the object code, if necessary. 

d. Translate the object code produced by the assembler 
or linker into Extended Tekhex format. The 
Intersystem Communication section of your System 
Users Manual provides a general algorithm for 
conversion to Extended Tekhex fonmat. 



Prepare the 8540 

Start up your 8540 and enter the following command to select the 8048 
emulator: 

> SEL 8048 <CR> 

The SEL command automatically sets the emulation mode to 0. 
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Create the Extended Tekhex Load Module 




Prepare the 8540 




(Start up the 8540.) 




> SEL 8048 <CR> 




> F 40 11F 00 <CR> 




> D 40 11F <CR> 




Establish Communication 




Download the Load Module 


1 


Terminate Communication 






3967-14 



Fig. 7H-12 Host computer commands for preparing demonstration program 



Zero Out Memory . Before you download any code, use the OS/40 F (Fill) 
command to fill 8540 program memory with zeros. Later, when you examine 
memory, the zeros make it easy to identify the beginning and end of your 
code. (Zeroing out memory has no effect on how the program is loaded.) 
Enter the following command line to fill memory from address 40 through 
address 11F with zeros: 

> F 40 11F 00 <CR> 
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Check That Memory Was Filled with Zeros . Check the contents of memory 
with the OS/ 40 D (Dump) command. The D command's display shows the data 

in hexadecimal format, and also shows the corresponding ASCII 

characters. Display the contents of memory addresses 40 — 11F with the 
following command line: 

> D 40 11F <CR> 

0123456789ABCDEF 

000040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000050 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 , 

000070 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 , 

000090 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 , 

OOOOAO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 , 

OOOOBO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

OOOOCO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 , 

OOOODO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 , 

OOOOEO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 , 

OOOOFO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

000110 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 , 



Download the Load Module to the 8540 

Be sure that your 8540 and your host computer are connected via an 
RS-232-C-compatible communications link. Then perform the following 
steps to download the Tekhex load module to 8540 program memory. (Refer 
to the Intersystem Communication section of your System Users Manual to 
determine the commands and parameters that are appropriate for your host 
computer.) 

a. Enter the 8540 COM command to establish communication. 
(The parameters of the COM command are host-specific.) Log 
on to your host and execute any necessary host 
initialization coiranands. 

b. Enter the command line that downloads the Tekhex load 
module to the 8540. This command line consists of a host 
computer command that performs the download, followed by a 
null character (CTRL-@ on most terminals) and a carriage 
return. COM places the object code in 8540 program memory, 
and puts the program symbols into the symbol table in 8540 
system memory. 

c. Log off from your host, and then terminate COM command 
execution by entering the null character, then pressing the 
ESC key. 



Once you've downloaded the program to the 8540, skip ahead to the 
heading "Run the Demonstration Program." 
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CASE 4: PATCH THE PROGRAM INTO MEMORY 



8048 Emulator Specifics Users 



This discussion shows you how to patch the demonstration program into 
8540 (or 8550) program memory using the P command, and then add the 
program symbols into the symbol table using the ADDS command. 

Ordinarily, you would load the object code and symbols from a binary or 
hexadecimal load file, as illustrated for Cases 1, 2, and 3. The 
procedure presented here is not normally used for preparing a program 
for execution. Use this procedure only if you have no standard means 
for preparing the program, but would still like to try out your 
emulator. 



Start Up the 8540 

Start up your 8540 and enter the following command to select the 8048 
emulator: 

> SEL 8048 <CR> 

The SEL command automatically sets the emulation mode to 0. 



Zero Out Memory 

Before you patch in any code, use the OS/40 F (Fill) command to fill 
8540 program memory with zeros. Later, when you examine memory, the 
zeros make it easy to identify the beginning and end of your code. 
Enter the following command line to fill memory from address 40 through 
address 11F with zeros: 

> F 40 11F 00 <CR> 



Check That Memory Was Filled with Zeros . Check the contents of memory 
with the OS/40 D (Dump) command. The D command's display shows the data 
in hexadecimal format, and also shows the corresponding ASCII 
characters. Display the contents of memory addresses 40 — 11F with the 
following command line: 



> D 40 


11F <CR> 

































1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


c 


D 


E 


F 


000040 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


000050 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


000060 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


000070 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


000080 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


000090 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


OOOOAO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


OOOOBO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


OOOOCO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


OOOODO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


OOOOEO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


OOOOFO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


000100 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


000110 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 . . . 



nu cC 
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Patch the Object Code into Memory 

The OS/40 P (Patch) command stores a sequence of bytes into memory, 
replacing the previous memory contents. Enter the following command to 
store the object code for the first three instructions in the program 
(MOV R1, MOV R7, and CLR A) starting at location 100: 

> P 100 B932 BF05 27 <CR> 



I CLR A 
I 
MOV R7,#TSIZE 

MOV R1,#TABLE 

patch address 

Now patch in the next four instructions (ADD, INC, DJNZ, and MOV R2)... 

> P 105 61 19 EF05 AA <CR> 

... and now the last four instructions (MOV A, NOP, MOVP A, and NOP). 

> P 10A 23F7 00 A3 00 <CR> 

Finally, patch in the Exit SVC information at address 40: 

> P 40 00421A <CR> 

You'll check the contents of memory later in this demonstration. 



Put Symbols into the Symbol Table 

Later in this demonstration, you will use symbols from the demonstration 
program (START, LOOP, TSIZE, and TABLE) when communicating with OS/40. 
Whenever you use a symbol in a command line, OS/40 consults a symbol 
table in 8540 system memory to find the values that the symbol stands 
for. Enter the following command line to add the program symbols to the 
symbol table, along with their values: 

> ADDS START=100 L00P=106 -S TSIZE=5 TABLE=4032 <CR> 

The ADDS command cannot provide all the symbol-related information that 
is provided by the SYMLO command (as in Cases 1 and 2) or the COM 
command (as in Case 3). Because this information is missing, some of 
the displays you produce later in this demonstration will not match the 
symbolic displays shown in this manual. For more information on the 
ADDS command, refer to the Command Dictionary of your System Users 
Manual . 

You've patched the demonstration program into program memory and placed 
the program symbols in the symbol table. Now it's time to run the 
program . 
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RUN THE DEMONSTRATION PROGRAM 



From now until the end of the demonstration, the commands you are to 
enter are shown in lowercase. If you are not logged in to an 8560, you 
may enter commands in either lowercase or uppercase. If you are using 
an 8560, you must enter the name of every command in lowercase (and your 
system prompt is "$", not ">"). 

Now that you've loaded the program into memory, you need to: 

• verify that the program was loaded correctly; and 

• put values into the table in memory, for the program to add. 



Check Memory Contents Again . Before you loaded the program, you filled 
memory locations 40 — 11F with zeros. Look at the same memory area again 
with the following command line: 



> d 40 ' 


If 


<CR> 

































1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


c 


D 


E 


F 




0040 


00 


42 


1A 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 .B 


» • • • • 


0050 


00 


00 


00 


00 




00 


r\r\ 




r\ri 


00 


WW 


00 


An 

WW 


00 




00 


« w S S 


0060 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




0070 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




0080 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




0090 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




OOAO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




OOBO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




OOCO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




OODO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




OOEO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




OOFO 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 




0100 


B9 


32 


BF 


05 


27 


61 


19 


EF 


05 


AA 


23 


F7 


00 


A3 


00 


00 .2..'a....# 




0110 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 





The object code is loaded in two different blocks; 

• The 8048 machine instructions are loaded at address 100 
(specified by the first ORG directive in the source code). 

• The information for the Exit SVC is loaded at address 40 
(specified by the second ORG directive). 

The contents of the table at address 32 are still undefined, but you'll 
put some values into the table in just a few minutes. 

Turn On Symbolic Display . Enter the following command to tell the sys- 
tem to modify its displays by replacing hexadecimal numbers with symbols 
from your program, where appropriate. 
> symd on <CR> 
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Disassemble the Object Code . The DI (Disassemble) command displays 
memory contents both in hexadecimal notation and in assembly language 
mnemonics. You can use the DI command to verify that the object code in 
memory corresponds to your source code. Enter the following command to 
disassemble the area of memory occupied by the executable part of your 
program: 

> di 100 lOe <CR> 



LOG 


INST 


MNEM 


OPER 


SECTION 


(DEMO) 






START 


B932 


MOV 


R1,#32 


+000102 


BF05 


MOV 


R7,#05 


+000104 


27 


CLR 


A 


LOOP 


61 


ADD 


A,@R1 


+000106 


19 


INC 


R1 


+000107 


EF05 


DJNZ 


R7,#05 0105 


+000109 


AA 


MOV 


R2,A 


+000 10A 


23F7 


MOV 


A,#F7 


+000 IOC 


00 


NOP 




+000 10D 


A3 


MOVP 


A,@A 


+000 10E 


00 


NOP 




+00010E 


12 


NOP 





Compare the DI display with the assembler listing you generated earlier, 
or refer back to Fig. 7H-10. 

The line "SECTION (DEMO)" in the DI display indicates that the object 
code being disassembled comes from the program section called DEMO. In 
fact, the entire memory area used by your program (location through 

the end of the program location 10E) belongs to section DEMO. This 

section was declared by the SECTION directive in the source code. (If you 
used the ADDS command to create your symbols, as in Case 4, the section 
name shown in the DI display is NO. SECTION.) 

The LOC (location) column of the DI display contains information that 
enables you to correlate the display with your assembler listing. The 
symbols START and LOOP in the DI display correspond to the labels START 
and LOOP in the source code. For those lines of the display where the 
location does not correspond to a label in the symbol table, DI 
substitutes the address of the instruction relative to the beginning of 
the section, as shown in the address field of your assembler listing. 
If you haven't loaded the pertinent symbols and related information into 
the symbol table (using a command such as SYMLO), the DI command 
supplies absolute (actual) addresses in the LOC column. (Since section 
DEMO begins at address 0, the relative address, or offset , is the same 
as the absolute address in this display. This offset feature is much 
more useful for sections that don't start at address 0.) 

Now you've seen that your system can use the symbol table to translate 
numbers into symbols to make a display easier to read. Your system can 
also translate a symbol in a command line into an address. For example, 
since your system knows that the symbol START is equivalent to the 
address 100, you could have entered the DI command in any of the 
following ways: 
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di 100 10E 
di START 10E 
di start start+Oe 
di 100 START+OE 



Notice that a symbol can be entered in either lowercase or uppercase. 

The feature that enables DOS/50 and OS/40 to correlate symbols from your 
program with the numbers they represent is termed symbolic debug . 



Put Values into the Table in Memory . The demonstration program sums five 
numbers from a table in memory. Use the P (Patch) command to store the 
numbers 1, 2, 3, 4, and 5 in the table. Do you remember what the 
address of the table is? It doesn't matter, as long as you remember 
that the symbol TABLE represents that address. 

> p table 0102030405 <CR> 



address of string of bytes to be stored 
table: 4032 at addresses 4032—4036 



Check the Contents of the Table . Use the D command to display the 
contents of the table. (When you don't specify an upper boundary for 
the area to be dumped, the D command dumps 16 bytes.) 

+ — ^_„« lower address: 4032 

I 

I + — upper address: omitted 

I I (defaults to lower address + OF) 



> d table <CR> 

23456789ABCDEF01 
004032 01 02 03 04 05 27 EB 8F C3 3C EB B6 9D 2B 00 42 ...'...<...+.. .B 

Notice that bytes 4032 — 4036 (the table) contain the values you patched 
in. Bytes 4037 — 4041 contain random data left over from previous system 
operations. 

The following command dumps only the contents of the table: 

> d table table^-tsizs-l <CR> 

23456789ABCDEF01 
004032 01 02 03 04 05 
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Start Program Execution 

Enter the G (Go) command to start program execution at location 100, the 
transfer address specified by the END directive in the source code. (If 
you followed "Case 4: Patch the Program into Memory," you must enter G 
START instead.) 

> £ <CR> 





table 

accumulator pointer 

1 1 


sum of 

table 
1 


pass 

counter 
1 


LOG INST MNEM 
010D A3 MOVP 
010D <BREAK 


1 1 

V V 

OPERAND EADD A PSW FLAGS TR RB RO R1 
A,@A 00 08 00 00 00 19 37 
TRACE> 


1 

V 

R2 R3 R4 
OF A6 FD 


1 

V 

R5 R6 R7 
00 BE 00 



The program executes, and when the Exit SVC occurs, the program breaks 
(stops), and the contents of the emulator registers are displayed. The 
Exit SVC uses the accumulator, so the sum of the numbers in the table is 
transferred into R2: 1+2+3+4+5=0F. 



MONITOR PROGRAM EXECUTION 

You have assembled, loaded, and executed the demonstration program. The 
rest of this demonstration shows you some commands for monitoring 
program execution. You can watch the changes in the emulator's 
registers and observe the effect of each instruction as the program 
proceeds. 



Trace All Instructions . The TRA (TRAce) command lets you observe the 
changes in the 8048 registers as the program proceeds. When you enter a 
TRA command and then start execution with the G command, display lines 
are sent to the system terminal. As each instruction executes, the 
display line shows the instruction (as in the Disassemble display) and 
the contents of the registers after that instruction has executed. 
Enter the following command line to trace all of the program's 
instructions: 

> tra all <CR> 



REV SEP 1983 7H-61 



8048 Demonstration Run 



8048 Emulator Specifics Users 



Enter the command G START (or G 100) to resume program execution at the 
beginning of the program: 

> g start <CR> 

As the program executes, the following trace is displayed. Remember 
that you can type CTRL-S to suspend the display and CTRL-Q to resume the 
display. 



LOG 


INST 


MNEM 


OPERAND 


EADD 


A PSW 


FLAGS 


TR 


RB 


RO 


R1 R2 


R3 


R4 


R5 


R6 


R7 


SECTION 


(DEMO) 
































START 


B932 


MOV 


R1,#32H 




07 


08 


00 


00 


00 





19 


32 07 


A6 


FD 


00 


BE 


00 


+000102 


BF05 


MOV 


R7,#05H 




07 


08 


00 


00 


00 





19 


32 07 


A6 


FD 


00 


BE 


05 


+000104 


27 


CLR 


A 




00 


08 


00 


00 


00 





19 


32 07 


A6 


FD 


00 


BE 


05 


LOOP 


61 


ADD 


A,@R1 




01 


08 


00 


00 


00 





19 


32 07 


A6 


FD 


00 


BE 


05 


+000106 


19 


INC 


R1 




01 


08 


00 


00 


00 





19 


33 07 


A6 


FD 


00 


BE 


05 


+000107 


EF05 


DJNZ 


R7,#05H 


0105 


01 


08 


00 


00 


00 





19 


33 07 


A6 


FD 


00 


BE 


04 


LOOP 


61 


ADD 


A,@R1 




03 


08 


00 


00 


00 





19 


33 07 


A6 


FD 


00 


BE 


04 


+000106 


19 


INC 


R1 




03 


08 


00 


00 


00 





19 


34 07 


A6 


FD 


00 


BE 


04 


+000107 


EF05 


DJNZ 


R7,#05H 


0105 


03 


08 


00 


00 


00 





19 


34 07 


A6 


FD 


00 


BE 


03 


LOOP 


61 


ADD 


A,@R1 




06 


08 


00 


00 


00 





19 


34 07 


A6 


FD 


00 


BE 


03 


+000106 


19 


INC 


R1 




06 


08 


00 


00 


00 





19 


35 07 


A6 


FD 


00 


BE 


03 


+000107 


EF05 


DJNZ 


R7,#05H 


0105 


06 


08 
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02 
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OA 
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01 
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19 
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R1 




OF 


08 


00 


00 
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01 
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R7,#05H 
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OF 


08 


00 


00 
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19 
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A6 


FD 


00 


BE 


00 
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AA 
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R2,A 




OF 


08 


00 


00 
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19 
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A6 


FD 


00 


BE 


00 
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MOV 
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F7 


08 


00 


00 
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19 
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A6 


FD 


00 


BE 


00 
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00 
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F7 


08 


00 


00 
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19 
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A6 


FD 


00 


BE 


00 
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A3 
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00 


08 


00 


00 


00 





19 


37 OF 


A6 


FD 


00 


BE 


OC 


+000 10D 


<BREAK 


TRACE) 


> 





























After the accumulator is cleared, the program begins to store the sum of 
the numbers being added. The 8048 ADD A,§R1 instruction adds a number 
from the table into the accumulator. Because the accumulator is also 
used for the Exit SVC, the program transfers the sum of numbers 
(1+2+3+4+5=0F) from the accumulator into R2. 

Register R7, the pass counter^ is set to contain 5 at the beginning of 
the program. It decreases by one (because of the DJNZ instruction) each 
time a number is added into the accumulator. The program ends after 
register R7 reaches zero. 

The R1 register, set to contain 32 at the start of the program, 
increments (because of the INC R1 instruction) each time a number is 
added to the accumulator. At the end of the program, the R1 register 
has been incremented five times and contains 37. 
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Trace to the Line Printer . By adding the parameter >LPT to a command, 
you can direct that command's output to the line printer instead of to 
the system terminal. First, verify that your line printer is properly 
connected and powered up. Then enter the following command to execute 
the program with trace output directed to the line printers 



> g start >LPT <CR> 



NOTE 



If you're operating in TERM mode with an 856O, use one of the 
following commands in place of the command shown: 

• g start I Ipir sends the display to the 8560 line 
printer, 

• g start \>LPT sends the display to the line printer 
on the 8540 or 8550. 



Trace Jump Instructions Only . Another way to monitor the program's 
execution is to look only at the jump instructions. By tracing the jump 
instructions, you can still observe the changes in the registers, but 
you save time and space by not tracing the instructions within the loop. 
Enter the following command line to trace only the jump instructions 
when the loop is being executed: 

> tra jmp loop IO8 <CR> 



r — upper address } Within this range, 

} only jump instructions 

• — lower address } are traced. 
(105) 



Again, enter the G command 
following trace is displayed: 

> g start <CR> 



line to start program execution. The 
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As with the TRA ALL display, observe that register R7 (the pass counter) 
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is decremented. The R1 register (the table pointer) is incremented, and 

the accumulator stores the sum of the numbers from the table. With the 

TRA JMP command in effect, the instructions within the loop are not 
displayed c 



Check the Status of the Trace . The TRA command without any parameters 
displays the trace conditions that are presently set. Because you can 
have up to three trace selections in effect at the same time, it is 
useful to be able to see which trace selections are active. Check your 
trace status with the following command line: 

> tra <CR> 

TRACE ALL, 000000, OOFFFF 
TRACE JMP, LOOP, 0108 

As you've specified, TRA ALL is in effect for addresses 0—104, TRA JMP 
is in effect for addresses 105 — 108, and TRA ALL is again in effect for 
addresses 109 — FFFF. 



Set a Breakpoint after a Specific Instruction . Now that you've seen how 
the program adds the numbers together, here's a new task: to add only 
the third and fourth numbers from the table. To perfomi this task, you 
want the pass counter to contain 2, and the table pointer to contain 34 
(the address of the third number in the table). You can accc»nplish 
these changes without altering the object code in program memory. 
First, stop program execution after the pass counter and the table 
pointer have been set. While the program is stopped, enter new values 
for the pass counter and the table pointer. When execution resumes, the 
program treats the new values as if they were the original programmed 
values . 



Enter the following command line to trace all of the instructions as the 
program executes: 

> tra all <CR> 

Check the trace status with the following command line: 

> tra <CR> 

TRACE ALL, 0000, FFFF 



The TRA selections we set earlier are made obsolete by the TRA ALL 
command just entered. 

Now set a breakpoint so that the program stops after the table pointer 
and pass counter have been set. The following command causes the 
program to stop after it executes the MOV R? instruction at address 102: 

> bk 1 102 <CR> 



I + — breakpoint address 

I 

+ breakpoint number 
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(can be 1 or 2) 
Use the G command to start program execution: 

> g start <CR> 

LOG INST MNEM OPERAND EADD A PSW FLAGS TR RB RO R1 R2 R3 R4 R5 R6 R7 
SECTION (DEMO) 

START B932 MOV R1,#32H 07 08 00 00 00 19 32 07 A6 FD 00 BE 00 

+000102 BF05 MOV R7,#05H 07 08 00 00 00 19 32 07 A6 FD 00 BE 05 

+000102 <BREAK TRACE, BKPT1> 

The TRA ALL command enabled display of all instructions up to and 
including the instruction at the breakpoint. 



Set New Values in Pass Counter and Table Pointer; Check Results . Now 
that you've reached the breakpoint, you can change the contents of the 
registers while execution is stopped. The break display shows that R7 
(the pass counter) contains 5, and that the R1 register (the table 
pointer) points to address 32. Use the S (Set) command to set the 
number of passes to two and set the table pointer to 34: 

> s r1=34 r7=02 <CR> 



+ — contents of register R7 
contents of register R1 



The S command does not produce a display, but you can use the DS 
(Display Status) command to check the values in the registers you 
changed. DS displays the contents of each emulator register and status 
flag. Check the result of the previous S command with the following 
command line: 

> ds <CR> 

PC CHIP EPM A PSW TR RB REGISTERS 

0104 8048 Y OF 08 00 R0-R7= 19 34 OF A6 FD 00 BE 02 

A0-A7= 86 00 2F 40 49 09 7D 00 

IIP EI TI TC MB STACK RETURN TF FO F1 AN STF DMA IBF OBF FLG 
N 08 1F06 

The DS display shows that the pass counter and the table pointer now 
contain the new values. 

NOTE 



The DS display varies slightly for different microcomputers in 
the 8048 family. 
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Resume Program Execution . If you enter the G command with no parameters, 

program execution starts where it left off. Resume program execution 
after the breakpoint with the following command line: 

> g <CR> 

LOG INST MNEM OPERAND EADD A PSW FLAGS TR RB RO R1 R2 R3 R4 R5 R6 R7 
SECTION (DEMO) 

+000104 27 CLR A 00 08 00 00 00 19 34 OF A6 FD 00 BE 02 

LOOP 61 ADD A,§R1 01 08 00 00 00 19 34 OF A6 FD 00 BE 02 

+000106 19 INC R1 01 08 00 00 00 19 35 OF A6 FD 00 BE 02 

+000107 EF05 DJNZ R7,#05H 0105 01 OS 00 00 00 19 35 OF A6 FD 00 BE 01 

LOOP 61 ADD A,@R1 03 08 00 00 00 19 35 OF A6 FD 00 BE 01 

+000106 19 INC R1 03 08 00 00 00 19 36 OF A6 FD 00 BE 01 

+000107 EF05 DJNZ R7,#05H 0105 03 08 00 00 00 19 36 OF A6 FD 00 BE 00 

+000109 AA MOV R2,A OF 08 00 00 00 19 36 07 A6 FD 00 BE 00 

+000 10A 23F7 MOV A,#F7H F7 08 00 00 00 19 36 F7 A6 FD 00 BE 00 

+0001 OC 00 NOP F7 08 00 00 00 19 36 07 A6 FD 00 BE 00 

+0001 OD A3 MOVP A,§A 00 08 00 00 00 19 36 07 A6 FD 00 BE 00 
+000 10D <BREAK TRACE> 

Notice that the program performed two passes through the loop, and that 
the program added the third and fourth numbers in the table (3+4=7). 



SUMMARY OF 8048/8021/804lA/8022 EMULATOR DEMONSTRATION RUN 

You have assembled, loaded, executed, and monitored the demonstration 
run program. You have used the following commands: 

• SEL — selects the 8048 assembler and emulator 

• ASM — creates object code from an assembly language program 

• LINK — links object code into a load module 

• F — fills an area of memory with a specified value 

• D — displays memory contents in ASCII and hexadecimal format 

• LO — loads object code into memory 

• DI — translates memory contents into assembly language 
mnemonics 

• P — patches a string of bytes into memory 

• SYMD ON — turns on symbolic debug feature 

• G — begins or resumes program execution 

• TRA — selects instructions to be traced during program 
execution 

• BK — sets a breakpoint 

• S — modifies emulator processor registers 

• DS — displays the status of the emulator processor 
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Delete the Demonstration Run Files 

Now that you've finished the demonstration run, you can delete the 
source file, object file, listing file, and load file. If you're using 
an 8550, the source and object files are still available to you on the 
8048/8021/8041A/8022 emulator installation disk. If you're using an 
8560, remember that once you delete the source file (asm), there is no 
way of recovering it. 



Delete 8550 Files . If your files are on the 8550, use the following 
procedure to delete them. First use the USER command to move from the 
DEMO directory back into the directory you were in at the start of the 
demonstration. Recall that you marked that directory with the brief 
name /ROOT. 

> USER /ROOT <CR> 

Now enter the following command to delete the DEMO directory and the 
files it contains: 

> DEL /DEMO/* DEMO <CR> 

Delete ASM ? Y <CR> 

Delete LOAD ? Y <CR> 

Delete OBJ ? Y <CR> 

Delete ASML ? Y <CR> 

Delete DEMO ? Y <CR> 

Before deleting each file, DOS/50 asks you whether you really want to 
delete it. You type "Y" for yes. 



Delete 8560 Files . If your files are on the 856O, use the following 
procedure to delete them. Enter the following command to remove all 
files in the working directory, including the source file: 

$ rm * <CR> 

Now move from the demo directory back into the parent directory and 
remove the demo directory itself: 

$ cd .. <CR> 

$ rmdir demo <CR> 



Turn Off Your System 

For instructions on turning off your 8550 or 8540, refer to the Learning 
Guide of your System Users Manual. 
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Resume Program Execution . If you enter the G command with no parameters, 

program execution starts where it left off. Resume program execution 
after the breakpoint with the following command line: 

> £ <CR> 

LOG INST MNEM OPERAND EADD A PSW FLAGS TR RB RO R1 R2 R3 R4 R5 R6 R7 
SECTION (DEMO) 

+000104 27 CLR A 00 08 00 00 00 19 34 OF A6 FD 00 BE 02 

LOOP 61 ADD A,§R1 01 08 00 00 00 19 34 OF A6 FD 00 BE 02 

+000106 19 INC R1 01 08 00 00 00 19 35 OF A6 FD 00 BE 02 

+000107 EF05 DJNZ R7,#05H 0105 01 08 00 00 00 19 35 OF A6 FD 00 BE 01 

LOOP 61 ADD A,§R1 03 08 00 00 00 19 35 OF A6 FD 00 BE 01 

+000106 19 INC R1 03 08 00 00 00 19 36 OF A6 FD 00 BE 01 

+000107 EF05 DJNZ R7,#05H 0105 03 08 00 00 00 19 36 OF A6 FD 00 BE 00 

+000109 AA MOV R2,A OF 08 00 00 00 19 36 07 A6 FD 00 BE 00 

+000 10A 23F7 MOV A,#F7H F7 08 00 00 00 19 36 F7 A6 FD 00 BE 00 

+000 IOC 00 NOP F7 08 00 00 00 19 36 07 A6 FD 00 BE 00 

+00010D A3 MOVP A,§A 00 08 00 00 00 19 36 07 A6 FD 00 BE 00 
+00010D <BREAK TRACE> 

Notice that the program performed two passes through the loop, and that 
the program added the third and fourth numbers in the table (3+4=7). 



SUMMARY OF 8048/8021/804l A/8022 EMULATOR DEMONSTRATION RUN 

You have assembled, loaded, executed, and monitored the demonstration 
run program. You have used the following commands: 

• SEL — selects the 8048 assembler and emulator 

• ASM — creates object code from an assembly language program 

• LINK — links object code into a load module 

• F — fills an area of memory with a specified value 

• D — displays memory contents in ASCII and hexadecimal format 

• LO — loads object code into memory 



DI == translates m 



emery contents into assembly language 



mnemonics 

• P — patches a strir^ of bytes into memory 

• SYMD ON — turns on symbolic debug feature 

• G — begins or resumes program execution 

• TRA — selects instructions to be traced during program 
execution 

• BK — sets a breakpoint 

• S ^ — modifies emulator processor registers 

• DS — displays the status of the emulator processor 
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Delete the Demonstration Run Files 

Now that you've finished the demonstration run, you can delete the 
source file, object file, listing file, and load file. If you're using 
an 8550, the source and object files are still available to you on the 
8048/8021/8041A/8022 emulator installation disk. If you're using an 
8560, remember that once you delete the source file ( asm ) , there is no 
way of recovering it. 



Delete 8550 Files . If your files are on the 8550, use the following 
procedure to delete them. First use the USER command to move from the 
DEMO directory back into the directory you were in at the start of the 
demonstration. Recall that you marked that directory with the brief 
name /ROOT. 

> USER /ROOT <CR> 

Now enter the following command to delete the DEMO directory and the 
files it contains: 

> DEL /DEMO/» DEMO <CR> 



Delete 


ASM 


? 


Y <CR> 


Delete 


LOAD 


7 


Y <CR> 


Delete 


OBJ 


9 


Y <CR> 


Delete 


ASML 


7 


Y <CR> 


Delete 


DEMO 


7 


Y <CR> 



Before deleting each file, DOS/50 asks you whether you really want to 
delete it. You type "Y" for yes. 



Delete 8560 Files . If your files are on the 856O, use the following 
procedure to delete them. Enter the following command to remove all 
files in the working directory, including the source file: 

$ rm * <CR> 

Now move from the demo directory back into the parent directory and 
remove the demo directory itself: 

$ cd .. <CR> 

$ rmdir demo <CR> 



Turn Off Your System 

For instructions on turning off your 8550 or 8540, refer to the Learning 
Guide of your System Users Manual. 
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Section 8 
PROM PROGRAMMER SPECIFICS 



This section describes the general use of the PROM 
Programmer, and provides a place to insert your PROM 
Programmer Specifics supplements. 



NOTE 

If you are using a multi-board emulator, refer to your 
Emulator Specifics supplement for more information 
on using your PROM Programmer. 



USING THE PROM 
PROGRAMMER 

The 8500 MDL Series PROM Programmer consists of three 
assemblies: 

1 . The controller is a circuit board that is installed in the 
8540 mainframe. 

2. The front panel assembly is installed inthe 8540 front 
panel. 

3. The characteristic module is a circuit card that you 
insert into the front panel assembly in order to 
configure your PROM Programmer for a particular set 
of PROM devices. 

Following are step-by-step procedures for inserting and 
using a characteristic module. It is assumed that the PROM 
Programmer Controller, front panel assembly, and 
operating system ROM have been installed according to 
the procedures in the PROM Programmer Controller 
Installation Manual. The steps within each procedure must 
be performed in the specified order. 



CAUTION 



Do not start up or turn off t fie 8540 wfjen you fiave a 
PROM device inserted in tfie zero-insertion-force 
(ZIP) socket of the cfiaracteristic module. Voltage 
transients may damage your PROM. 



Inserting a Characteristic Module 

Slide the characteristic module upward into the front panel 
assembly until the front panel of the characteristic module 
fits snugly against the front panel assembly. See Fig. 8-1 
for the correct angle of insertion. When the characteristic 
module is properly inserted, the ZIF socket on the 
characteristic module protrudes from the front panel 
assembly. 




Fig. 8-1. Inserting a characteristic module. 



O 
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Starting Up the 8540 

1 . First, be certain that you do not have a PROM device in 
the ZIF socket of the characteristic module. Then, start 
up the 8540. (For start-up instructions, refer to the 
Learning Guide section of this manual.) The SELF 
TEST indicator on the front panel assembly of the 
PRi^iVi Programmer should light briefly (5 seconds 
maximum), and then go out. 

2. Turn on the PROM POWER switch, located on the 
PROM Programmer front panel assembly. The READY 
indicator will light if a characteristic module is present 
in the front panel assembly and the PROM 
Programmer has powered up correctly. 

If the SELF TEST indicator stays on, or if the READY 
indicator does not light, enter the PSTAT command on 
your system terminal. The PSTAT display should 
indicate the problem. For PSTAT display examples and 
error message explanations, see the PROM Pro- 
grammer Specifics supplement for the characteristic 
module you are using. If the problem persists, refer to 
the PROM Programmer Controller Installation Manual. 



) CAUTION I 

De ceridin if mi pin 1 uf ihe FRGM m ai the end ui ihe 
ZIF socket next to the lever. The PROM Programmer 
cannot always detect an incorrectly socketed device: 
damage to the PROM can result from an attempt to 
program an incorrectly socketed PROM. 

Most PROM devices have an indentation near pin 1 ; 
other PROMs may have a small dot painted on that 
end. Refer to the manufacturer's specifications if you 
are in doubt. 



PROM Programmer Commands 

The system commands that control the PROM Programmer 
are described in detail in each PROM Programmer 
Specifics supplement. 



Turning Off the 8540 

Before you turn off the 8540, be certain to remove the 
PROM from the characteristic module. 



Inserting a PROM into the Characteristic 
Module 



S CAUTION < 



To prevent potential damage to your PROM device, do 
not insert or remove a PROM when the SELF TEST 
light on the front panel assembly is ON. 

You can insert or remove a PROM when any of the 
following conditions are true: 

• the characteristic-module has not been inserted into the 
front panel assembly, or 

• the 8540 is not powered up, or 

• the PROM POWER switch is OFF, or 

• the READY light on the front panel assembly is ON. 

At the time of this writing, all supported PROMs are 
inserted according to the followin" "r^'^edur'^' 

1 . Raise the lever on the ZIF socket of the characteristic 
module. 

2. Insert the PROM into the ZIF socket so that pin 1 of the 
PROM is next to the lever. 

3. Depress the lever so that the socket grips the pins of 
the PROM. 



PROM PROGRAMMER 
SPECIFICS SUPPLEMENTS 

Each characteristic module is accompanied by a PROM 
Programmer Specifics supplement that provides information 
specific to the characteristic module. Each supplement is 

vj^oi^itou iO uc n loof icij iiKw n mo iiiaiiuai. 

These PROM Programmer Specifics supplements are 
numbered as if they were separate sections of this manual. 
For example, the supplement that documents the 
2716/2732 PROM Programmer Module is labeled 
"Section 8A," andthe first illustration in that supplement is 
numbered "Fig. 8A-1." Similarly, other supplements are 
labeled Sections SB, 8C, etc. Figures, pages, and tables are 
numbered accordingly. 

Each supplement presents the following information: 

• A list of PROMs supported bythe characteristic module. 

specific to the characteristic module. 

• One or more examples of each command supported by 
the characteristic module. 

• Any irregularities that should be noted. 

• Features designed to support PROMs with special 
programming needs. 



8-2 



l^ktronix 



® 

COMMITTED TO EXCELLENCE 



This manual supports the This manual supports a software/firmware 

following TEKTRONIX products: module that is compatible with 

8550 8540 Product DOS/50 V02.xx-xx (8550) 

Option Option OS/40 V 01. xx-xx (8540) 

31 31 8550F31 



PLEASE CHECK FOR CHANGE INFORMATION 
AT THE REAR OF THIS MANUAL. 



8500 

MODULAR MDL SERIES 

2716/2732 

PROM PROGRAMMER 
SPECIFICS 

USERS MANUAL 



Tektronix, Inc. 
P.O. Box 500 

Beaverton, Oregon 97077 Serial Number 

070-3868-00 First Printing OCT 1981 

Product Group 61 Revised NOV 1 981 



LIMITED RIGHTS LEGEND 

Software License No. 



Contractor: Tektronix, Inc 

i-zvpicji iciiiv/i I yji i_iiiiiLc;u i 1 1' 

Used: Entire document subject to limited rights. 



iiiiLc^u iiivjiiio L^aia luci mi ii_.aiiui i ividiicfu 



Those portions of this technical data indicated as limited rights data shall not, 
without the written permission of the above Tektronix, be either (a) used, 
released or disclosed in whole or in part outside the Customer, (b) used in whole 
or in part by the Customer for manufacture or, in the case of computer software 
documentation, for preparing the same or similar computer software, or (c) used 
by a party other than the Customer, except for: (i) emergency repair or overhaul 
work only, by or for the Customer, where the item or process concerned is not 
otherwise reasonably available to enable timely perforrnance of the work, 
provided that the release or disclosure hereof outside the Customer shall be 
made subject to a prohibition against further use, release or disclosure; or(ii) 
release to a foreign government, as the interest of the United States may 
require, only for information or evaluation within such government or for 
emergency repair or overhaul work by or for such government under the 
conditions of (i) above. This legend, together with the indications of the portions 
of this data which are subject to such limitations shall be included on any 
reproduction hereof which includes any part of the portions subject to such 
limitations. 



RESTRICTED RIGHTS IN SOFTWARE 

The software described in this document is licensed software and subject to 
restricted rights. The software may be used with the computer for which or with 
which it was acquired. The software may be used with a backup computer if the 
computer for which or with which it was acquired is inoperative. The software 
may be copied for archive or backup purposes. The software may be modified or 
combined with other software, subject to the provision that those portions of the 
derivative software incorporating restricted rights software are subject to the 
same restricted rights. 

Copyright© 1981 Tektronix, Inc. All rights reserved. Contents of this publication 
may not be reproduced in any form without the written permission of Tektronix, 
Inc. 

Products of Tektronix, Inc. and its subsidiaries are covered by U.S. and foreign 
patents and/or pending patents. 

TEKTRONIX, TEK, SCOPE-MOBILE, and i^J are registered trademarks of 
Tektronix, Inc. TELEQUIPMENT is a registered trademark of Tektronix U.K. 
Limited. 

Printed in U.S.A. Specification and price change privileges are reserved. 
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Section 8A 
2716/2732 PROM PROGRAMMER SPECIFICS 



INTRODUCTION 

This supplement is designed to br inserted into one of the )llow nc ^octionr 

• Section 8 of the 8540 System Users Manual, 

• Section 8 of the 8550 System Users Manual (DOS/50 Version 2), or 

• Section 9 of the 8550 System Users Manual (DOS/50 Version 1). 

Throughout this supplement, "your System Users Manual" refers to the 8550 System Users 
Manual or 8540 System Users Manual. "Module 1" refers to the 2716/2732 PROM 
Programmer Module. 




The PROM Programmer module is static-sensitive. To avoid damage to the 
module, handle it as little as possible in high -static situations. Pick up the 
module by the body, not by the edge connectors. Avoid sliding the module over 
any surface. 



DEVICES SUPPORTED 

Module 1 enables the PROM Programmer to program a set of similar devices. Each of the 
PROMs supported by Module 1 is a MOS, single supply, byte-wide chip. Table 8A-1 lists the 
device types supported by Module 1 . 

Table 8A-1 
Programmable Devices Supported by Module 1 



Manufacturer 


Device 


PROM type^ 


Description 


Texas Instruments 


TMS 2508 


2508/TI 


1Kx8 bit EPROM 


Intel 


2758 


2758/1 


IK x 8 bit EPROM 


Intel 


2758 SI 865 


2758S1 865/1 


IK X 8 bit EPROM 


Texas Instruments 


TMS 251 6 


2516/TI 


2K X 8 bit EPROM 


Intel 


2716 


2716/1 


2K X 8 bit EPROM 


Intel 


2816 


2816/1 


2K X 8 bit EEPROM 


Texas Instruments 


TMS 2532 


2532/TI 


4K X 8 bit EPROM 


Intel 


2732 


2732/1 


4K X 8 bit EPROM 


Intel 


2732A 


2732A/I 


4K X 8 bit EPROM 


Motorola 


MCM 68764 


68764/M 


8K X 8 bit EPROM 



The names that specify the devices supported by Module 1 . 



@ 
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PROMs with programming characteristics similar to a PROM type maybe available from other 
manufacturers. The PROM Programmer with Module 1 programs any PROM that has exactly the 
same specifications as one of those listed above. Refer to the manufacturer's data sheets, and 
use the PROM type identification of the device in the table whose specifications match those of 
the one you have. 



If you attempt to use a PROM which is not supported by this characteristic module, you will 
receive an error message: 

> CPR 3232 /Z 40 (specifying a Zilog 3232 PROM) 

CPR: Error 80 PROM type not supported 




The PROM Programmer does not verify that the PROM inserted matches the 
PROM type specification. The voltage levels necessary to successfully program 
a PROM vary from one type to another. If the wrong PROM type is specified, your 
PROM may be destroyed. 



PROM PROGRAMMER COMMANDS 

There are five system commands for use with the PROM Programmer: 

• CPR (Compare PROM) compares the contents of the specified PROM addresses with the 
corresponding data in program memory, and displays any differences. 

• RPR (Read PROM) reads the contents of the specified PROM addresses into program 
memory. 

• WPR (Write PROM) writes data from program memory into the PROM. 

• PSTAT (PROM status) displays the current status of the PROM Programmer, including 
any error conditions. 

• PTYPE (PROM TYPE) displays information about the characteristic module currently 
inserted in the front panel of the PROM Programmer, informing the user what PROMs it 
supports and what their characteristics are. 

The PSTAT and PTYPE commands are issued without parameters. The following subsections 
describe the parameters that are used with the CPR, RPR, and WFR commands. 



Command Parameters 

The following are necessary parameters for any invocation of the CPR, RPR, or WPR commands. 

• Memlo specifies the starting address from which data is transferred to the PROM or to 
which data is placed after being read from the PROM. 
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• Promtype is the alphanumeric name specifying the PROM with which you are working. 
See Table 8A-1 for the promtype associated with your chip, or use the PTYPE command 
described below. The promtype must be entered exactly as shown; letters must be 
uppercase. 

• Promlo specifies the (hexadecimal) PROM address which you wish to be the starting point 
for the specified command. 

• Promhi specifies the ending PROM address. 



Command Modifiers 

For illustrations of the use of the command modifiers, see the following subsection, PROM 
Programmer Command Dictionary. 

NOTE 

Syntax for this section has been updated for DOS/50 Version 2 and OS/40. If 
you are using DOS/50 Version 1, all "dash modifiers" (such as -L, -M) should be 
"colon modifiers" (:L :M). The Technical Notes section of the 8550 System 
Users Manual describes the differences between Version 1 and Version 2. 

Modifier Meaning 

-a Provides inverted addressing (hi=0, low=l ). Use -A in applications where the levels 

applied to the PROM's address pins are inverted. 

-d Data is stored in the PROM in inverted form (hi=0, low=1 ). For a read operation (RPR) 

this means that the data from the PROM is inverted before being stored in program 
memory. During a write (WPR) data is inverted before being written into PROM. 

-I For the 8-bit PROMs supported by Module 1 , this modifier indicates that data being 

read from (or written into) the PROM represents the least significant bytes of 1 6-bit 
words in program memory. See also -R. 

-m For 8-bit PROMs, this modifier indicates that data being read from (or written into) 

PROM represents the most significant bytes of 1 6-bit words in program memory. See 
also -R. 

-n Specifies that no erase check is performed before a write operation. See the WPR 

command for examples. 

-r The -R modifier is used when the data in program memory is arranged in 16-bit 

words. -R indicates that the bytes are arranged in reverse order in program memory, 
that is, least significant byte first, followed by most significant byte. 

-R is used with -M or -L. For example, if modifiers -M and -R are entered as part of a 
RPR command when reading an 8-bit PROM, the bytes read from the PROM will be 
placed in the second byte of each 1 6-bit word. See the RPR command for examples. 
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PROM Programmer Command Dictionary 

This subsection gives the syntax and use of each PROM Programmer command as it pertains to 
Module 1 . The format is the same as that of the Command Dictionary of your System Users 
Manual. 



cpr [-a] [ 



-dlL-l J[-r] 



SYNTAX 



memlo promtype promlo promhi 



EXPLANATION 

Compares the contents of the specified PROM addresses with the contents of program memory, 
starting at the given memory address. The locations of any differences are displayed. If the 
contents match, no message is displayed. 

The CPR command is useful when you wish to verify that the data in the PROM is the same as the 
data in a specified region of program memory. 



EXAMPLES 

Enter the following command to read the contents of locations 0-40 of an Intel 271 6 PROM into 
locations 0-40 of program memory. 

> RPR 2716/1 40 

Now dump program memory to see what's been read: 

> D 40 

1 



0123456789ABCDEF 
0000 54 48 49 63 20 49 53 20 41 20 64 46 53 54 2E 2E 
0010 64 48 49 63 20 49 63 20 41 20 54 45 53 64 2E 2E 



THIS IS A TEST. 
THIS IS A TEST. 



0020 64 48 49 63 20 49 63 20 41 20 54 46 53 54 2E 2E THIS IS A TEST. 
0030 54 48 49 53 20 49 53 20 41 20 54 46 53 64 2E 2E THIS IS A TEST. 
0040 54 T 
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Compares PROM With Memory 



If the data was read correctly, a CPR command at this point will return no message. 

> CPR 3716/1 40 



To illustrate the response you receive when an error is detected, use the P command to patch 
new data into two locations in program memory. 

> P 05 00 

> P 07 00 

Now compare the contents again: 

> CPR 2716/1 40 

*** COMPARE ERROR AT PROM ADDRESS =00005H 
*** COMPARE ERROR AT PROM ADDRESS=00007H 

The discrepancies introduced into locations 5 and 7 of program memory were identified as 
errors by the CPR command. 

If you use the -A modifier in a CPR command, the address given in a "COMPARE ERROR" 
message is actually the complement of the value that was applied at the PROM's address pins. 
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pstat 



SYNTAX 



EXPLANATION 

Displays the current condition of the PROM Programmer. Normally, PSTAT will report "no 
errors." Conditions which prompt an error message include power failure, the absence of a 
characteristic module, or PROM Programmer power off. 

Error messages are discussed elsewhere in this supplement. 



EXAMPLES 



When no errors are present: 

> PSTAT 

... NO PROM PROGRAMMER ERRORS DETECTED . . . 



Reporting an error condition: 

> PSTAT 

PP ERROR— POWER FAIL 
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PTYPE 

Displays Device Types 



SYNTAX 



ptype 



EXPLANATION 

Displays information about PROMs supported by Module 1. The display consists of four 
columns: 

• PROM TYPE: the name that specifies each PROM supported by the characteristic module. 
Each name is the model number of the primary source manufacturer, followed by a slash 
and one or more letters specifying the manufacturer. For example, Intel's 2716 PROM is 
identified as 2716/1. (Note that there are no spaces in the PROM TYPE designation.) 

• MAX ADDRESS: the maximum addressable location of each PROM listed. For example, 
3FFH indicates a total of 400H addressable bytes (0 through 3FF). 

• ERASED STATE: the state of the bits (high or low) when the PROM device has been erased. 
For the 8-bit PROMs supported by Module 1, HI is FF and LOW is 00. 

• WORD LENGTH: the number of bits per word for each PROM. Since Module 1 supports only 
1 -byte (8-bit) wide PROMs, word length for all PROMs listed is eight. 









EXAMPLES 




> PTYPE 












PROM TYPE 


MAX ADDRESS 


ERASED 


STATE 


WORD 


LENGTH 


2508 /TI 


3FFH 


HI 






8 


2768/1 


3FFH 


HI 






8 


2758S1865/I 


3FFH 


HI 






8 


2516/TI 


7FFH 


HI 






8 


2716/1 


7FFH 


HI 






8 


2816/1 


7FFH 


HI 






8 


2532/TI 


FFFH 


HI 






8 


2732/1 


FFFH 


HI 






8 


2732A/I 


FFFH 


HI 






8 


68764/M 


IFFFH 


HI 






8 
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SYNTAX 



r -m-\ 



L 



rpr [-a] [-d] 



_ -I J [-r] memlo promtype promlo promhi 



EXPLANATION 

Reads the contents of the specified PROM addresses into the specified location in program 
memory. No message is displayed unless an error condition exists. 

EXAMPLES 

First use the F command to fill program memory with EE. Later, when you examine memory, the 
EEs make it easy to see that new data was read in. 

> F 40 EE 

> D 40 

0123466789ABCDEF 
0000 EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE 

UU J.(J JtilJj r^P' CjCj Pflfj CjSHu JL£j CjCj r***' hjEj r f P f ILCj j p-Hi EiEj f f r* CjIL r*"' •> 

0020 EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE 

0030 EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE 

0040 EE 



Now use the RPR command to read the contents of memory locations 0-40 of a Texas 
Instruments 2532 PROM into program memory, beginning at address 0. Then dump the 
contents of program memory, to verify that it now contains new data from the PROM. 

> RPR 2532/TI 40 

> D 40 

0123456789ABCDEF 
0000 54 48 49 63 20 49 53 20 41 20 54 45 53 54 2E 2E 
0010 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E 
0020 54 48 49 53 20 49 63 20 41 20 64 46 53 54 2E 2E 
0030 54 48 49 53 20 49 53 20 41 20 54 46 53 64 2E 2E 
0040 54 



THIS 


IS 


A TEST. 


THIS 


IS 


A TEST. 


THIS 


IS 


A TEST. 


THIS 


IS 


A TEST. 


T 







In the example above, no optional modifiers were needed. Next, assume that our 8-bit PROM is 
to be used as the most significant half of a 1 6-bit memory system. Again, fill program memory 
with EE's read the PROM, anddumnthe results- This time, however. the-M modifier is used. 



> F 40 EE 



> RPR -M 2632/ TI 40 

> D 40 

12 3 4 5 6 



789ABCDEF 
0000 54 EE 48 EE 49 EE 53 EE 20 EE 49 EE 63 EE 20 EE 
0010 41 EE 20 EE 64 EE 45 EE 53 EE 64 EE 2E EE 2E EE 
0020 64 EE 48 EE 49 EE 63 EE 20 EE 49 EE 53 EE 20 EE 
0030 41 EE 20 EE 54 EE 45 EE 63 EE 54 EE 2E EE 2E EE 
0040 54 



T 


H 


I 


S 




I. 


S 


A 




T 


E 


S 


T. 




T 


H 


I 


S 




I. 


S 


A 




T 


E 


S 


T. 




T 
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The results of the D command show that the 8-bit bytes received from the PROM are now stored 
in the most significant byte positions of a 16-bit data base in program memory. 

Compare those results with the example below, in which memory is filled with EE and the RPR 
command line includes the -L modifier. 

> F 40 EE 

> RPR -L 2532/ TI 40 

> D 40 

0123456789ABCDEF 

0000 EE 54 EE 48 EE 49 EE 53 EE 20 EE 49 EE 53 EE 20 .T.H.I.S. .I.S. 

0010 EE 41 EE 20 EE 54 EE 45 EE 53 EE 54 EE 2E EE 2E .A. .T.E.S.T 

0020 EE 54 EE 48 EE 49 EE 53 EE 20 EE 49 EE 53 EE 20 .T.H.I.S. .I.S. 

0030 EE 41 EE 20 EE 54 EE 45 EE 53 EE 54 EE 2E EE 2E .A. .T.E.S.T 

0040 EE 



Notice that this time the PROM bytes have been placed in the least significant positions of the 
1 6-bit data base. 

Now assume that the PROM contains most significant bytes, and that the data base in program 
memory should consist of 1 6-bit data arranged in reverse order (least significant byte followed 
by most significant byte). Note that -R should be used only with either a -L or a -M modifier. 

> F 40 EE 

> RPR -MR 2532/TI 40 

> D 40 

0123456789ABCDEF 
0000 EE 54 EE 48 EE 49 EE 53 EE 20 EE 49 EE 53 EE 20 
0010 EE 41 EE 20 EE 64 EE 45 EE 55 EE 54 EE 2E EE 2E 
0020 EE 54 EE 48 EE 49 EE 53 EE 20 EE 49 EE 53 EE 20 
0030 EE 41 EE 20 EE 54 EE 45 EE 53 EE 54 EE 2E EE 2E 
0040 EE 

The combined -M and -R modifiers produce the same results in program memory as does the -L 
modifier. 

If the PROM contained the least significant bytes of a 1 6-bit memory system, and the program 
memory data were arranged in reverse order, the -L and -R modifiers would be used. The output 
would look exactly like that produced by the example above using -M. 



.T, 


,H 


.1 


.S. 




.1, 


• S 


.A. 




,T 


.E. 


,3 


.T. 




.T. 


,H 


.1 


.S, 




.1, 


.S 


.A. 




.T 


.E. 


,S 


.T. 


, , 
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Writes to PROM 



SYNTAX 

r-mi 

wpr [-a] [-d]L-l J[-r] [-n] memlo promtype promlo promhi 



EXPLANATION 

Writes the contents of program memory beginning at the address memlo into the section of a 
promtype PROM between promlo and promhi. The resulting PROM data is checked for 
accuracy. If the data matches, no message is reported; otherwise, an error message is printed. 
For more detailed descriptions of these parameters, see the Command Parameters subsection 
earlier in this supplement. 

Any byte into which you wish new data written must be erased before it is written to. 

With one exception, the PROMs supported by Module 1 are EPROMs — that is, they may be 
erased by exposure to ultra-violet light. The PROM Programmer does not perform this erasure; it 
must be done by a unit designed for that purpose. 

The exception is the Intel 2816 EEPROM (promtype 2816/1). This is an electrically-erasable 
PROM. If you specify the entire EEPROM address space in the WPR command, the PROM 
Programmer erases the entire chip. Otherwise, it will erase only those portions of the EEPROM 
which it has been ordered to program. To erase individual bytes of the 281 6, write FF into their 
memory locations. The -N modifier must be used when programming a 2816/1 type PROM. 

If asked to write to an EPROM, the PROM Programmer checks the designated memory space to 
ensure that it is erased and ready to accept new information. You may disable this erase check by 
using the -N command modifier. This does not allow you to reprogram an unerased portion of a 
chip. 



EXAMPLES 

When a write command is properly executed, no message is returned. 

> WPR 20 2732/1 80 



If you do not use the -N modifier, an attempt to write to a PROM which has not been fully erased 
will produce an error message. 

> WPR 20 2732/1 80 

PP ERROR— DEV NOT ERASED 

Suppose, however, that you have programmed a PROM, discovered an error in your code, and 
wish to change only a few bytes of memory. If the bits you wish to change are currently in an 
erased state, you may disable the erase check by using modifier -N, and write over the section of 
the device that contains the code to be changed. 
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The following example first writes data from program memory into the PROM, and then reads 
back from the device: 

> WPR 00 2716/1 00 10 

> RPR 00 2716/1 00 10 

> D 10 

0123456789ABCDEF 
0000 54 48 4D 53 20 49 53 20 49 20 54 45 53 54 2E 2E THMS IS I TEST. . 
0010 54 T 

Next new data is patched into locations 02 and 08 of program memory, and the new contents of 
program memory are displayed: 

> P 02 49 



> 


p 


08 


41 


> 


D 


: 


LO 









1 



23456789ABCDEF 
0000 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E THIS IS A TEST. . 
0010 54 T 

Now you can write the corrected data to the PROM. Normally, an EPROM would need to be 
erased (with ultra-violet light) before the new write operation. In this case, however, since both 
changes required changing bits which were still in an erased state (1 ), the programming can be 
done "over the top" of the old data. "M" (0100101 1) is changed to "I" (01001001), and "I" is 
changed to "A" (01000001). 

> WPR 00 2716/1 10 

PP ERROR— DEV NOT ERASED 

An error occurs because the -N modifier was omitted. Try again: 

> WPR -N 00 2716/1 00 10 



The write operation was successful, so you are prompted for your next command. 

If you use modifier -N and attempt to write into a region of the PROM that is not 
reprogrammable, you will be informed that the write operation was not successful (that the 
resulting data in the PROM does not match program memory). 

> WPR -N 2716/1 24 OFF 

PP ERROR — DEV NOT REPROG (device not reprogrammable) 

Since the PROM Programmer has changed bits which were in an erased state, and has been 
unsuccessful at changing others, this may leave you with a garbled mess in your PROM. 
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ERROR MESSAGES 

PROM Programmer error messages are identified by the keywords "PP ERROR." They are 

vjiviuovj iiiiv/ ivv\j v^aicvjfoi ICO. 

The first group of messages may appear in response to a PROM Programmer command (CPR, 
PSTAT, PTYPE, RPR, or WPR) during normal operation. They indicate that the PROM 
Programmer is unable to execute the command. This condition may be easily fixed (by turning on 
PROM Programmer power, for example), or it may require a call to your Tektronix service 
representative. 

The second group of messages announces problems discovered by the PROM Programmer self- 
test procedure, executed automatically during power up. 

If you see an error message without the words "PP ERROR," refer to the section on Error 
Messages in your System Users manual. 



Execution Errors 

The following error messages may be received in response to a PROM Programmer command 
(CPR, PSTAT, PTYPE, RPR, or WPR). 

PP ERROR— CHAR MOD ABSENT. There is no characteristic module inserted in the front 
panel of the PROM Programmer. 

PP ERROR— CONFIG MEM CKSUM. The characteristic module memory shows an error. Call 
your service representative. Since the PROM Programmer Controller is not malfunctioning, you 
should still be able to use a different characteristic module. 

PP ERROR— DEV NOT ERASED. A WPR (write) command was attempted, but the PROM is 
not erased for correct programming. See the discussion of the WPR command elsewhere in this 
supplement for more information on erasing a PROM. 

PP ERROR— DEV NOT REPROG. After writing to a programmable device, the PROM 
Programmer compares the data in the PROM with program memory to ensure that the data was 
correctly transmitted. The message "DEV NOT REPROG" indicates that an attempt was made to 
write to a device, and the results In the PROM do not match program memory. This may indicate 
a bad part, or an attempt to use the -N modifier with the WPR command on an unerased section 

of dpvinp rriAmnrv ^pp thp Hicnission ni thp WPR rnmmanrl picpuuhprp in thic ciinnlpmpnt 
_. — .. — ,. _ — ..._ _._ . _. ..._ ... .. _.. _. — _.__... — _ ... ...._ __p,p,. _. . ._. — 

PP ERROR— POWER FAIL. The operation was aborted due to an Internal power failure. Try the 
operation again. If the POWER FAIL message appears frequently, call your service 
representative. 

PP ERROR— PROM POWER OFF. The power switch on the PROM Programmer front panel 
assembly must be turned on before PROM Programmer commands can execute. 



8A-12 



@ 



271 6 PROM Programmer Specifics Users Error Messages 



Error 80 PROM type not supported. The promtype parameter entered with a CPR, RPR, or 
WPR command is not recognized by this characteristic module. For a list of PROMs supported 
and their promtype designations, see Table 8A-1 or enter the PTYPE command. Note that the 
promtype name must be entered exactly as shown. For example, 2732/i or 2732/INTEL are not 
accepted for the 2732/1 promtype. 



Power Up Errors 

Assuming you have powered up the PROM Programmer following the instructions in the 
introduction to this section, the READY indicator on the PROM Programmer front panel should 
light. If the READY indicator does not light, type in the PSTAT command. You may receive one of 
the responses listed above, or one of the following messages: 

PP ERROR— CPU 

PP ERROR— POWER CONTROL 

PP ERROR— RAM 

PP ERROR— ROM 

PP ERROR— SUPPLY MONITOR 

PP ERROR— SYST INTERFACE 

If you receive the message NO PROM PROGRAMMER ERRORS DETECTED, the PROM 
Programmer should be functioning correctly. The problem may be with the READY indicator. Try 
executing a command. 

The other error messages indicate a problem in the hardware or firmware of the PROM 
Programmer Controller. Call your service representative for assistance. 
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Those portions of this technical data indicated as limited rights data shall not, 
without the written permission of the above Tektronix, be either (a) used, 
released or disclosed in whole or in part outside the Customer, (b) used in whole 
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Section 8B 

8748/8741 A/8749/8755A PROM 
PROGRAMMER SPECIFICS 



INTRODUCTION 

This supplement is designed to be inserted into one of the following sections: 

• Section 8 of the 8540 System Users Manual, 

• Section 8 of the 8550 System Users Manual (DOS/50 Version 2), or 

• Section 9 of the 8550 System Users Manual (DOS/50 Version 1 ). 

Throughout this supplement, "your System Users Manual" refers to the 8550 System Users 
Manual or 8540 System Users Manual. "Module 2" refers to the 8748/8741 A/8749/8755A 
PROM Programmer Module. 




The PROM Programmer module is static-sensitive. To avoid damage to the 
module, handle it as little as possible in high-static situations. Pick up the 
module by the body, not by the edge connectors. Avoid sliding the module over 
any surface. 



DEVICES SUPPORTED 

Module 2 enables the PROM Programmer to program a set of similar devices. Table 8B-1 lists 
the device types supported by Module 2. 

Table 8B-1 
Programmable Devices Supported by Module 2 



Manufacturer 


Device 


PROM Type^ 


Description 


Intel 


8755A 


8755A/I 


2K X 8 bit MCS-85 Peripheral 
(EPROM with I/O) 


Intel 


8748 


8748/1 


1 K X 8 bit Microcomputer 


Intel 


8749 


8749/1 


2K X 8 bit Microcomputer 


Intel 


8741 A 


8741A/I 


IK X 8 bit Peripheral 
Interface Microcomputer 



The names that specify the devices supported by Module 2. 



(a) 
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Devices with programming characteristics similar to a PROM type may be available from other 
manufacturers. The PROM Programmer with Module 2 programs any device that has exactly the 
same specifications as one of those listed above. Refer to the manufacturer's data sheets, and 
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the one you have. 

If you attempt to use a device which is not supported by this characteristic module, you will 
receive an error message: 

> CPR 5252 /Z 40 (specifying a Zilog 3232 PROM) 

CPR: Error 80 PROM type not supported 




The PROM Programmer does not verify that the device inserted matches the 
PROM type specification. The voltage levels necessary to successfully program 
a device vary from one type to another. If the wrong PROM type is specified, your 
device may be destroyed. 



PROM PROGRAMMER COMMANDS 

There are five system commands for use with the PROM Programmer: 

• CPR (Compare PROM) compares the contents of the specified PROM addresses with the 
corresponding data in program memory, and displays any differences. 

• RPR (Read PROM) reads the contents of the specified PROM addresses into program 
memory. 

• WPR (Write PROM) writes data from program memory into the device. 

• PSTAT (PROM status) displays the current status of the PROM Programmer, including 
any error conditions. 

• PTYPE (PROM TYPE) displays the characteristic module currently inserted in the front 
panel of the PROM Programmer, informing the user what devices it supports and what 
their characteristics are. 

The PSTAT and PTYPE commands are issued without parameters. The following subsections 
describe the parameters that are used with the CPR, RPR, and WPR commands. 



Command Parameters 

The following are necessary parameters for any invocation of the CPR, RPR, or WPR commands. 

• Memlo specifies the starting address in program memory from which data will be 
transferred to the device or to which data is be placed after being read from the device. 

• Promtype is the alphanumeric name specifying the device with which you are working. 
See Table 8B-1 for the promtype associated with your device, or use the PTYPE command 
described below. The promtype must be entered exactly as shown; letters must be 
uppercase. 
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• Promlo specifies the (hexadecimal) PROM address which you wish to be the starting point 
for the specified command. 

• Promhi specifies the ending PROM address. 



Command Modifiers 

For illustrations of the use of the command modifiers, see the following subsection, PROM 
Programmer Command Dictionary. 

NOTE 

Syntax for this section has been updated for DOS/50 Version 2 and OS/40. If 
you are using DOS/50 Version 1, all "dash modifiers" (such as -L, -M) should be 
"colon modifiers" (:L :M). The Technical Notes section of the 8550 System 
Users Manual describes the differences between Version 1 and Version 2. 

Modifier Meaning 

-a Provides inverted addressing (high=0, low=1). Use -A in applications where the levels 

applied to the device's address pins are inverted. 

-d Data is stored in the device in inverted form (high=0, low=1). For a read operation 

(RPR) this means that the data from the device is inverted before being stored in 
program memory. During a write (WPR) data is inverted before being written into 
PROM. 

-I For the 8-bit devices supported by Module 2, this modifier indicates that data being 

read from (or written into) the device represents the least significant bytes of 1 6-bit 
words in program memory. See also -R. 

-m For 8-bit devices, this modifier indicates that data being read from (or written into) the 

device memory represents the most significant bytes of 16-bit words in program 
memory. See also -R. 

-n Specifies that no erase check is performed before a write operation. See the WPR 

command for examples. 

-r The -R modifier is used when the data in program memory is arranged in 16-bit 

words. -R indicates that the bytes are arranged in reverse order in program memory, 
that is, least significant byte first, followed by most significant byte. 

-R is used with -M or -L. For example, if modifiers -M and -R are entered as part of a 
RPR command when reading an 8-bit device, the bytes read from the device will be 
placed in the second byte of each 1 6-bit word. See the RPR command for examples. 
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PROM Programmer Command Dictionary 

This subsection gives the syntax and use of each PROM Programmer command as it pertains to 
Module 2. The format is the same as that of the Command Dictionary of your System Users 
Manual. 



SYNTAX 



cpr [-8] [-d]L-l J[-r 



] memlo promtype promlo promhi 



EXPLANATION 

Compares the contents of the specified device addresses with the contents of program memory, 
starting at the given memory address. The locations of any differences are displayed. If the 
contents match, no message is displayed. 

The CPR command is useful when you wish to verify that the data in the device is the same as the 
data in a specified region of program memory. 



EXAMPLES 

Enter the following command to read the contents of locations 0-40 of an Intel 8749 device into 
locations 0-40 of program memory. 

> RPR 8749/1 40 

Now dump program memory to see what's been read: 

> D 40 

C 



0123456789ABCDEF 
0000 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E 
0010 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E 
0020 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E 
0030 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E 
0040 54 



THIS IS A TEST. 
THIS IS A TEST. 
THIS IS A TEST. 
THIS IS A TEST. 



If the data was read correctly, a CPR command at this point will return no message. 

> CPR 8749/1 40 
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To illustrate the response you receive when an error is detected, use the P command to patch 
new data into two locations in program memory: 

> P 05 00 

> P 07 00 

Now compare the contents again: 

> CPR 8749/1 40 

*** COMPARE ERROR AT PROM ADDRESS=00005H 
*** COMPARE ERROR AT PROM ADDRESS =0000 7H 

The discrepancies introduced into locations 5 and 7 of program memory were identified as 
errors by the CPR command. 

If you use the -A modifier in a CPR command, the address given in a "COMPARE ERROR" 
message is actually the complement of the value that was applied to the device's address pins. 
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SYNTAX 



DSiaT 



EXPLANATION 

Displays the current condition of the PROM Programmer. Normally, PSTAT will report "no 
errors." Conditions which prompt an error message include power failure, the absence of a 
characteristic module, or PROM Programmer power off. 

Error messages are discussed elsewhere in this supplement. 



EXAMPLES 



> PSTAT 

... NO PROM PROGRAMMER ERRORS DETECTED 

Reporting an error condition: 

> PSTAT 

PP ERROR-- CHAR MOD ABSENT 
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SYNTAX 
ptype 



EXPLANATION 

Displays information about devices supported by Module 2. The display consists of four 
columns; 

• PROM TYPE: the name that specifies each device supported by the characteristic module. 
Each name is the model number of the primary source manufacturer, followed by a slash 
and one or more letters specifying the manufacturer. For example, Intel's 8755A device is 
identified as 8755A/I. (Note that there are no spaces in the PROM TYPE designation.) 

• MAX ADDRESS: the maximum addressable location of each device listed. For example, 
3FFH indicates a total of 400H addressable bytes (0 through 3FF). 

• ERASED STATE: the state of the bits (high or low) when the device has been erased. For the 
8-bit devices supported by Module 2, HI is FF and LOW is 00. 

• WORD LENGTH: the number of bits per word for each device. Since Module 2 supports only 
1 -byte (8-bit) wide devices, word length for all devices listed is eight. 



EXAMPLES 

> PTYPE 

PROM TYPE MAX ADDRESS ERASED STATE WORD LENGTH 

8755A/I 7FFH HI 8 

8748/1 3FFH LO 8 

8749/1 7FFH LO 8 

8741A/I 3FFH LO 8 
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SYNTAX 



-mT 



rpr [-a] [-d]|_-l J[-r] memlo promtype promlo promhi 



EXPLANATION 

Reads the contents of the specified device addresses into the specified location in program 
memory. No message is displayed unless an error condition exists. 

EXAMPLES 

First use the F command to fill program memory with BE. Later, when you examine memory, the 
EEs make it easy to see that new data was read in. 

> F 40 EE 

> D 40 

0123456789ABCDEF 

0000 EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE 

0010 EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE 

0020 EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE 

vj\jij(j lliiii CjIIj Jlilii Hjili HiJtlj Hiili HixIj uilj iIjJIj HjIL iliiit xbiij Hiili ulL ILJli HiHf 

0040 EE 

Now use the RPR command to read the contents of memory locations 0-40 of an Intel 8755A 
device into program memory, beginning at address 0. Then dump the contents of program 
memory, to verify that it now contains new data from the device. 

> pp^ n 07i:,c A / T fj 4./-) 



> D 40 

0123456789ABCDEF 
0000 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E 



0010 54 48 49 53 20 49 53 20 
0020 54 48 49 53 20 49 53 20 



20 54 45 53 54 2E 2E 
20 54 45 53 54 2E 2E 



0030 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E 
0040 54 



THIS 


IS 


A 


TEST. 


THIS 


IS 


A 


TEST. 


THIS 


IS 


A 


TEST. 


THIS 


IS 


A 


TEST. 


T 









In the example above, no optional modifiers were needed. Next, assume that our 8-bit device is 
to be used as the most significani half of a 1 6-bii memory system. Again, fili program memory 
with EE's, read the device, and dump the results. This time, however, the -M modifier is used. 

> F 40 EE 

> RPR -M 8755A/I 40 



> D 40 

0123456789ABCDEF 

0000 54 EE 48 EE 49 EE 53 EE 20 EE 49 EE 53 EE 20 EE T.H. 

0010 41 EE 20 EE 54 EE 45 EE 53 EE 54 EE 2E EE 2E EE A. . 

0020 54 EE 48 EE 49 EE 53 EE 20 EE 49 EE 53 EE 20 EE T.H. 

0030 41 EE 20 EE 54 EE 45 EE 53 EE 54 EE 2E EE 2E EE A. . 

0040 54 T 



,S. . 
,E.S, 
,S. , 

,E . S . 



S. 
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The results of the D command show that the 8-bit bytes received from the device are now stored 
in the most significant byte positions of a 16-bit data base in program memory. 

Compare those results with the example below, in which memory is filled with EE and the RPR 
command line includes the -L modifier. 

> F 40 EE 

> RPR -L 8755A/I 40 

> D 40 

0123456789ABCDEF 
0000 EE 54 EE 48 EE 49 EE 53 EE 20 EE 49 EE 53 EE 20 
0010 EE 41 EE 20 EE 54 EE 45 EE 53 EE 54 EE 2E EE 2E 
0020 EE 54 EE 48 EE 49 EE 53 EE 20 EE 49 EE 53 EE 20 
0030 EE 41 EE 20 EE 54 EE 45 EE 53 EE 54 EE 2E EE 2E 
0040 EE 

Notice that this time the bytes of data from the device have been placed in the least significant 
positions of the 16-bit data base. 

Now assume that the device contains most significant bytes, and that the data base in program 
memory should consist of 1 6-bit data arranged in reverse order (least significant byte followed 
by most significant byte). Note that -R should be used only with either a -L or a -M modifier. 

> F 40 EE 

> RPR -MR 8755A/I 40 



.T 


H 


I 


S 




I 


S. 


.A 




T 


E 


S 


.T 




.T 


H 


I 


S 




.1 


S. 


.A 




T 


E 


S 


T 





> D 40 

0123456789ABCDEF 

0000 EE 54 EE 48 EE 49 EE 53 EE 20 EE 49 EE 53 EE 20 

0010 EE 41 EE 20 EE 54 EE 45 EE 53 EE 54 EE 2E EE 2E 

OOcu CjCj 0'± EjHj "±0 thUj t» ihiL, ua CjE^ ou CjCj tw CjCj oo iLjL ou 

0030 EE 41 EE 20 EE 54 EE 45 EE 53 EE 54 EE 2E EE 2E 
0040 EE 



T.H.I.S. .I.S, 
A. .T.E.S.T. . 



.T.E.S.T. 



The combined -M and -R modifiers produce the same results in program memory as does the -L 
modifier. 

If the device contained the least significant bytes of a 1 6-blt memory system, and the program 
memory data were arranged In reverse order, the -Land -R modifiers would be used. The output 
would look exactly like that produced by the example above using -M. 
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SYNTAX 



r-mn 



wpr [-a] [-d]|_-l _ [-r] [-n] memlo promtype promlo promhi 



EXPLANATION 

Writes the contents of program memory beginning at the address memlo into the section of a 
promtype device between promlo and promhi. The resulting data in the device memory is 
checked for accuracy. If the data matches, no message is reported; otherwise, an error message 
is printed. For more detailed descriptions of these parameters, see the Command Parameters 
subsection earlier in this supplement. 

Any byte into which you wish new data written must be erased before it is written to. 

The devices supported by Module 2 may be erased by exposure to ultra-violet light. The PROM 
Programmer is not designed to do this erasure. It must be done by a unit designed for that 
purpose. 

When a WPR command is issued, the PROM Programmer examines the designated memory 
area to ensure that it is erased and ready to accept new information. You may disable this erase 
check by using command modifier -N. This does not allow you to reprogram an unerased portion 
of a device. 



EXAMPLES 

When a write command is properly executed, no message is returned. 

> WPR 30 8748/1 80 

If you do not use the -N modifier, an attempt to write to a device which has not been fully erased 
will produce an error message. 

> WPR £0 8748/1 80 

PP ERROR— DEV NOT ERASED 

Suppose, however, that you have programmed a device, discovered an error in your code, and 
wish to change only a few bytes of memory. If the bits you wish to change are currently in an 
/-k^■oc■o/^ ototo \/oii nrtoi/ HicaKjQ tho ornco /^hoQj^ h\/ ijcjnn mQrjjf ior — Nj and wrjte over ths sectiop of 

the device that contains the code to be changed. 
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The following example writes data from program memory into the device, and then reads back 
from the device: 

> WPR 00 8755A/I 00 10 

> RPR 00 8755A/I 00 10 

> D 10 

0123456789ABCDEF 
0000 54 48 4D 53 20 49 53 20 49 20 54 45 53 54 2E 2E THMS IS I TEST. . 
0010 54 T 

Next new data is patched into locations 02 and 08 of program memory, and the new contents of 
program memory are displayed: 

> P 02 49 

> P 08 41 



> D 10 



0123456789ABCDEF 
0000 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E THIS IS A TEST. . 
0010 54 T 

Now you can write the corrected data to the device. Normally, the device would need to be erased 
(with ultra-violet light) before the new write operation. In this case, however, since both changes 
required changing bits which were still in an erased state (1), the programming can be done 
"over the top" of the old data. "M" (01 001 01 1 ) is changed to "I" (01 001 001 ), and "I" is changed 
to "A" (01 000001). 

> WPR 00 8755A/I 10 

PP ERROR— DEV NOT ERASED 

An error occurs because the -N modifier was omitted. Try again: 

> WPR -N 00 8755A/I 00 10 



The write operation was successful, so you are prompted for your next command. 

If you use modifier -N and attempt to write into a region of the device that is not reprogrammable, 
you will be informed that the write operation was not successful (that the resulting data in the 
device does not match program memory). 

> WPR -N 8748/1 24 OFF 

PP ERROR — DEV NOT REPROG (device not reprogrammable) 

Since the PROM Programmer has changed bits which were in an erased state, and has been 
unsuccessful at changing others, this may leave you with a garbled mess in your device. 
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ERROR MESSAGES 

PROM Programmer error messages are identified by the keywords "PP ERROR." They are 
divided into two Categories. 

The first aroUO of messaaes mav aooear \^ rocnonco tn p PRHM Prnnrammpr rnmmanri iCPR 

PSTAT, PTYPE, RPR, or WPR) during normal operation. They indicate that the PROM 
Programmer is unable to execute the command. This condition may be easily fixed (by turning on 
PROM Programmer power, for example), or it may require a call to your Tektronix service 
representative. 

The second group of messages announces problems discovered by the PROM Programmer self- 
test procedure, executed automatically during power up. 

If you see an error message without the words "PP ERROR," refer to the section on Error 
Messages in your System Users manual. 



bxecution brrors 

The following error messages may be received in response to a PROM Programmer command 
(CPR, PSTAT, PTYPE, RPR, or WPR). 

PP ERROR— CHAR MOD ABSENT. There is no characteristic module inserted in the front 
panel of the PROM Programmer. 

PP ERROR— CONFIG MEM CKSUM. The characteristic module memory shows an error. Call 
your service representative. Since the PROM Programmer Controller is not malfunctioning, you 
should still be able to use a different characteristic module. 

PP ERROR— DEV NOT ERASED. A WPR (write) command was attempted, but the device is 
not erased for correct programming. See the discussion of the WPR command elsewhere in this 
supplement for more information on the erasing of a device. 

PP ERROR— DEV NOT REPROG. After writing to a programmable device, the PROM 
Programmer compares the data in the device with program memory to ensure thatthe data was 
correctly transmitted. The message "DEV NOT REPROG" indicates that an attempt was made to 
write to a device, and the results in the device memory do not match program memory. This may 
indicate a bad part, or an attempt to use the -N modifier with the WPR command on an unerased 
section of device memory. See the discussion of the WPR command elsewhere in this 
supplement. 

PP ERROR— POWER FAIL. The operation was aborted due to an internal power failure. Try the 
operation again. If the POWER FAIL message appears frequently, call your service 
representative. 

PP ERROR— PROM POWER OFF. The power switch on the PROM Programmer front panel 
assembly must be turned on before PROM Programmer commands can execute. 

Error 80 PROM type not supported. The promtype parameter entered with a CPR, RPR, or 
WPR command is not recognized by this characteristic module. For a list of devices supported 
and their promtype designations, see Table 8B-1 or enter the PTYPE command. Note that the 
promtype name must be entered exactly as shown. For example, 8748/i or 8748/INTEL are not 
accepted for the 8748/1 promtype. 
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Power Up Errors 

Assuming you have powered up the PROM Programmer following the instructions in the 
introduction to this section, the READY indicator on the PROM Programmer front panel should 
light. If the READY indicator does not light, type in the PSTAT command. You may receive one of 
the responses listed above, or one of the following messages: 

PP ERROR— CPU 

PP ERROR— POWER CONTROL 

PP ERROR— RAM 

PP ERROR— ROM 

PP ERROR— SUPPLY MONITOR 

PP ERROR— SYST INTERFACE 

If you receive the message NO PROM PROGRAMMER ERRORS DETECTED, the PROM 
Programmer should be functioning correctly. The problem may be with the READY indicator. Try 
executing a command. 

The other error messages indicate a problem in the hardware or firmware of the PROM 
Programmer Controller. Call your service representative for assistance. 
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Section 8C 
2764 PROM PROGRAMMER SPECIFICS 



INTRODUCTION 

This supplement is designed to be inserted into one of the following sections: 

• Section 8 of the 8540 System Users Manual, 

• Section 8 of the 8550 System Users Manual (DOS/50 Version 2), or 

• Section 9 of the 8550 System Users Manual (DOS/50 Version 1). 

Throughout this supplement, the phrase "your System Users Manual" refers to the 8550 System 
Users Manual or 8540 System Users Manual. The 2764 PROM Programmer Module is referred to 
as simply "the 2764 Module". 




The 2764 Module is static-sensitive. To avoid damage to ttie module, handle it as little 
as possible in high-static situations. Pick up the module by the body, not by the edge 
connectors. Avoid sliding the module over any surface. 

This supplement discusses the following topics: 

• The devices supported by the 2764 Module. 

• A demonstration run for the 2764 Module. 

• PROM Programmer commands, as they apply to the 2764 Module. 

• Error messages. 
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DEVICES SUPPORTED 

The 2764 Module enables the PROM Programmer to program a set of similar devices. Each of 
the PROMs supported by the 2764 Module is a MOS, single supply, byte-wide chip. Table 8C-1 
lists the device types supported by 2764 Module. 

Table 8C-1 
Programmable Devices Supported by the 2764 Module 



Manufacturer 


Device 


PROM Type^ 


Description 










Texas Instruments 


TMS 2564 


2564/TI 


8K X 8 bit EPROM 


Intel 


2764 


2764/1 


8K X 8 bit EPROM 


Intel 


27128 


27128/1 


16Kx8bitEPROM 


Intel 


2817 


2817/1 


2K X 8 bit EEPROM (This device 
includes programming control 



The name used in a PROM Programmer command to specify the device. 



Other PROMs, similar to the devices listed in Table 80-1 , may be available from other manufac- 
turers. If you are using such a device, verify that its programming specifications are identical to 
those of a listed device. If the specifications are identical, the PROM Programmer, with the 2764 
Module installed, will properly program the device. Use the appropriate PROM type (from Table 
8C~1) in your program.ming commands. 

If you attempt to use a PROM that is not supported by this PROM Programmer module, you wiii 
receive an error message: 

> CPR 5252/Z 40 (specifying a Zilog 3232 PROM) 



CPRi 



Error 80 PROM type not supported 




The PROM Programmer does not verify that the inserted device matches the PROM 
type that you specified. The voltage levels necessary to successfully program a PROM 
varv from one tvoe to another. If vou soecifv the wrono PROM tvoe. vour PROM mav 
be destroyed. 
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DEMONSTRATION RUN 

This demonstration run provides you with an introduction to PROM programming, using the 2764 
Module. This demonstration may also be used to verify the module's operation. 

The demonstration run consists of three steps. First, you'll load some test data into program 
memory. Then, you'll direct the PROM Programmer to program this test data into your target 
device. Finally, you'll read back the data to verify that it was correctly programmed into the 
PROM. 

This demonstration run uses the following conventions: 

1 . Underlined — Underlined characters in a command line must be entered from your system 
terminal. Those characters not underlined are system output. 

2. <CR> — Each command line ends with a carriage return. When a carriage return is to be 
entered, the symbol <CR> is used. 



Creating the Test Data 

The test data for this demonstration run is in the form of an ASCII string. First, clear part of the 
development system memory by filling it with zeros: 

> F 00 OOFF 00 <CR> 



Now enter the test data, using the following command (omit the -A modifier if you're using 
DOS/50 Version 1): 



> F 00 OOFF -A "TIME FOR COFFEE!" <CR> 



ng the D (Dump) command 


, examine 


the 


contents < 


Df memory 


and verify * 


that the 


rectly 


entered: 


































> D 00 OOFF 


<CR> 





































1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 








0000 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE 


0010 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE 


0020 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE 


0030 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE 


0040 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE 


0050 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE 


0060 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE 


0070 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE 


0080 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE 


0090 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE 


OOAO 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE 


OOBO 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE 


OOCO 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE 


OODO 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE 


OOEO 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE 


OOFO 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE 
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Programming the Target Device 

Plug the 2764 Module into the opening on your development system's front panel. Next, raise the 
2764 Module's ZIF socket handle, and install your target PROM into the ZIP socket. Align the 
PROM so that pin 1 is next to the ZIF socket handle. 




Be careful not to touch the pins of either your target device or the ZIF socket Damage 
from static discharge may result. 

Now, turn the PROM POWER switch on. The READY indicator on the PROM Programmer front 
panel assembly should now be lit. (If it is not lit, a problem exists in your PROM Programmer 
Controller; contact a Tektronix field service representative.) 

Now you can program the test data into your target PROM by entering one of the following 

nmnrommin/^ /^rvmrnonHe Cola^t tl-iQ r*r\mm^nri that ie orvi^rz-krvriot/i (r\r- \i/-\iir Ma\i\f\e\ t\ir\a 
|./i <>.'^i u ^ wv^i 1 11 1 iwi iviw. \j\ji\^\jK 11 iv^ «^<_>i I II ■ i«.4i i>^ vii«^i i«j iup|>/i v.>|.^i ic*t& iv/i yyjKjti \ji^vi\y^ iy^c«. 

> WFR 2764/1 00 OOFF <CR> (for 2764 PROMs) 

> WFR 27128/1 00 OOFF <CR> (for 27128 PROMs) 

> WFR 2564/TI 00 OOFF <CR> (for 2564 PROMs) 

> WFR -N 2817/1 00 OOFF <CR> (for 2817 PROMs) 

Remember to include the -N modifier in the command if your target device is a 2817. Otherwise, 
the PROM Programmer may think that the device is an unerased EPROM. 



Reading Bacl( the Test Data 

Now it's time to verify that the test data was accurately programmed in your PROM. First, fill the 
development system memory again with zeros: 

> F 00 OOFF 00 <CR > 

Next, enter one of the following commands to read the contents of the PROM into memon'. 
Select the command that is appropriate for your device type. 

> RFR 2764/1 00 OOFF <CR> (for 2764 PROMs) 
> RFR 27128/1 00 OOFF <CR> (for 27128 PROMs) 
> RFR 2564/1 00 OOFF <CR> (for 2564 PROMs) 
> RPR 2817/1 00 OOFF <CR> (for 2817 PROMs) 
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Locations 00 


— FF of memory 


' should now 


contain your 


test da 


ita again. 1 


ro find c 


following 


command: 


































> D 00 OOFF 


<CR> 





































1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 








0000 


54 


49 


4D 


45 
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46 
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52 
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4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE! 


0010 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 
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46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE! 


0020 


54 


49 


4D 


45 


20 
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52 
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46 
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45 
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FOR 


COFFEE! 


0030 


54 


49 


4D 


45 


20 


46 
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52 
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43 


4F 


46 


46 


45 


45 


21 
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FOR 


COFFEE! 


0040 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE! 


0050 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 
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COFFEE! 


0060 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE! 


0070 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE! 


0080 


54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE! 


0090 


54 
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OOAO 


54 
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OOBO 
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46 
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OOCO 
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46 


45 
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54 


49 


4D 


45 


20 


46 


4F 


52 


20 


43 


4F 


46 


46 


45 


45 


21 


TIME 


FOR 


COFFEE! 



If this display appears, the PROM was programmed correctly, and the 2764 Module is 
operational. 

If the display does not appear as shown here, either your target PROM or the 2764 Module is 
defective. Try the demonstration again, using a different target PROM to isolate the problem. If 
the module is defective, contact a Tektronix field service representative. 



Suinrndry 

This demonstration introduced you to the basic commands necessary to program PROMs with 
the 2764 Module. The following discussion explains these and other PROM Programmer com- 
mands in more detail. 

The demonstration run also verified the 2764 Module's operation. If you suspect that the module 
may not be operating properly, contact a Tektronix field service representative. 
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PROM PROGRAMMER COMMANDS 

Five operating system commands are used with the PROM Programmer: 

• CPR (Compare PROM) compares the contents of the specified PROM addresses with the 
corresponding data in program memory, and displays any differences. 

• RPR (Read PROM) reads the contents of the specified PROM addresses into program 
memory. 

• WPR (Write PROM) whtes data from program memory into the PROM. 

• PSTAT (PROM STATUS) displays the current status of the PROM Programmer, including 
any error conditions. 

• PTYPE (PROM TYPE) displays information about the PROM Programmer module currently 
installed in the front panel of the PROM Programmer: what PROMs are supported by the 
module, and what their characteristics are. 

This subsection gives the syntax and use of each PROM Programmer command as it pertains to 
the 2764 Module. The format is the same as that of the Command Dictionary of your 8550 or 
8540 System Users Manual. 

NOTE 

Syntax for this section corresponds to DOS/50 Version 2 and OS/40. If you are using 
DOS/50 Version 1, ail "dash modifiers" (such as -L, -M, etc.) should be "colon modifi- 
ers" (:L, :M, etc.). The Technical Notes section of the 8550 System Users Manual 
describes the differences between DOS/50 Version 1 and Version 2. 
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CPR 

Compares PROM With Memory 



cpr [-a] [-d] 



-m 
-I 



SYNTAX 

[-r] memlo promtype promlo promhi 



-a 



-m 



memlo 



promtype 



promlo 
promhi 



PARAMETERS 

Provides inverted addressing (hi = 0, low=1). Use -A in applications where the 
levels applied to the PROM's address pins are inverted. 

Data is stored in the PROM in inverted form (hi=0, low=1). For a compare 
operation (CPR), this means that the data from the PROM is inverted before 
being compared with program memory. 

For the 8-bit PROMs supported by the 2764 Module, this modifier indicates 
that data being read from the PROM represents the least significant bytes of 
16-bit words in program memory. See also -R. 

For 8-bit PROMs, this modifier indicates that data being read from the PROM 
represents the most significant bytes of 1 6-bit words in program memory. See 
also -R. 

When the data in program memory is arranged in 16-bit words, indicates that 
the bytes are arranged in reverse order in program memory; that is, the least 
sianificant bvte is first, followed bv the most significant bvte. 

The -R modifier is used with -M or -L. For example, if modifiers -M and -R 
are entered as part of a CPR command when reading an 8-bit PROM, the 
bytes read from the PROM will be compared with the second byte of each 
16-bit word. 

Specifies the starting address to which data is placed after being read from the 
PROM. 

The alphanumeric name specifying the PROM with which you are working. To 
determine the PROM type associated with your chip, see Table 8C-1 (earlier in 
this section), or use the PTYPE command. The promtype parameter must be 
entered exactly as shown; letters must be uppercase. 

Specifies the PROM address that you wish to be the starting point for the 
specified command. 

Specifies the ending PROM address. 
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EXPLANATION 

Th6 CPR Gornmand Gomnaros the c-ontsnts of the s'-'eGified PROM addresses with the contents 
of program memory, starting at the given memory address. The locations of any differences are 
displayed. If the contents match, no message is displayed. 

The CPR command is useful when you want to verify that the data in the PROM is the same as 
the data in a specified region of program memory. 



EXAMPLES 

Enter the following command to read the contents of locations 0—40 of an Intel 2764 PROM into 
locations — 40 of program memory. 

> RPR 2764/1 40 

Now dump program memory to see what's been read: 

> D 40 

0123456789ABCDEF 
0000 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E 
0010 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E 
0020 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E 
0030 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E 
0040 54 T 

If the data was read correctly, a CPR command at this point will not return a message: 

> CPR 27 64/1 p. 40 

Let's see what happens when an error is detected. Use the P command to patch new data into 
two locations in program memory. 

> P 05 00 

> P 07 00 

Now compare the contents again: 

> CPR 2764/1 40 



THIS 


IS 


A 


TEST 


THIS 


IS 


A 


TEST 


THIS 


IS 


A 


TEST 


THIS 


IS 


A 


TEST 



*** COMPARE ERROR AT PROM ADDRESS 00005H 
•** COMPARE ERROR AT PROM ADDRESS 00007H 



The CPR command identified the discrepancies introduced into locations 5 and 7 of program 
memory. 

NOTE 

If you include the -A modifier in the CPR command line, the address given in a "COM- 
PARE ERROR" message is actually the complement of the value that was applied at 
the PROM'S address pins. 
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PSTAT 

Reports PP Status 



SYNTAX 



pstat 



EXPLANATION 

The PSTAT command displays the current condition of the PROM Programmer. Normally, 
PSTAT will report "no errors". Conditions that prompt an error message include power failure, the 
absence of a PROM Programmer module, or PROM Programmer power off. 

Error messages are discussed later in this section. 



EXAMPLES 



When no errors are present: 

> PSTAT 

... NO PROM PROGRAMMER ERRORS DETECTED 



Reporting an error condition: 

> PSTAT 

PP ERROR— POWER FAIL 
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SYNTAX 






EXPLANATION 

The PTYPE command displays information about PROMs supported by the 2764 Module. The 
display consists of four columns: 

• PROM TYPE: the name that specifies each PROM supported by the PROM Programmer 
module. Each name is the model number of the primary source manufacturer, followed by a 
slash and one or more letters specifying the manufacturer. For example, the Intel 2764 
PROM is identified as 2764/1. (Note that there are no spaces in the PROM TYPE 
designation.) 

• MAX ADDRESS: the maximum addressable location of each PROM listed. For example, 
1 FFFH indicates a total of 2000H addressable bytes (00—1 FFF). 

• ERASED STATE: the state of the bits (high or low) when the PROM device has been erased. 
For all PROMs supported by the 2764 Module, HI is FF and LOW is 00. 

• WORD LENGTH: the number of bits per word for each PROM. Since the 2764 Module 
supports only byte-wide (8-bit) PROMs, the word length for all PROMs listed is 8. 







EXAMPLES 






> PTYPE 










PROM TYPE 


MAX ADDRESS 


ERASED STATE 


WORD 


LENGTH 


2764/1 


IFFFH 


HI 




8 


27128/1 


3FFFH 


HI 




8 


2817/1 


7FFH 


HI 




8 


2564/TI 


IFFFH 


HI 




8 
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RPR 

Reads PROM 



SYNTAX 


rpr [-a] [-d] 


-m' 
-1 


[-r] memlo promtype promlo promhi 


L " -1 



PARAMETERS 



-a 



-d 



-I 



-m 



Provides inverted addressing (hi==0, low=1). Use -A in applications wiiere the 
levels applied to the PROM's address pins are inverted. 

Data is stored in the PROM in inverted form (hi=0, low=1). For a read opera- 
tion (RPR), this means that the data from the PROM is inverted before being 
stored in program memory. 

For the 8-bit PROMs supported by the 2764 Module, this modifier indicates 
that data being read from the PROM represents the least significant bytes of 
16-bit words in program memory. See also -R. 

For 8-bit PROMs, this modifier indicates that data being read from PROM 
represents the most significant bytes of 1 6-bit v/ords in program memory. See 
also -R. 



-r 



When the data in program memory is arranged in 1 6-bit words, indicates that 
the bytes are arranged in reverse order in program memory; that is, the least 
significant byte is first, followed by the most significant byte. 

The -R modifier is used with -M or -L. For example, if modifiers -M and -R 
are entered as part of a RPR command when reading an 8-bit PROM, the 
bytes read from the PROM will be placed in the second byte of each 16-bit 
word. 



memlo 



Specifies the starting address to which data is placed after being read from the 
PROM. 



promtype 

promlo 
promhi 



The alphanumeric name specifying the PROM with which you are working. To 
determine the PROM type associated with your chip, see Table 80-1 (earlier in 
this section), or use the PTYPE command. The promtype parameter must be 
entered exactly as shown; letters must be uppercase. 

Specifies the PROM address that you wish to be the starting point for the 
specified command. 

Specifies the ending PROM address. 
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EXPLANATION 

The RPR command reads the contents of the specified PROM addresses into the specified 
location in program memory. No message is displayed unless an error is detected. 



EXAMPLES 

First, use the F command to fill program memory with the data byte EE. Later, when you examine 
memory, the EEs will make it easy to see that new data was read in. 

> F 40 EE 

> D 40 

0i25456789ABCDEF 

0000 EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE 

0010 EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE 

0020 EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE 

0030 EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE 

0040 EE 

Now use the RPR command to read the contents of memory locations — 40 of a Texas Instru- 
ments 2564 PROM into program memory, t)eginning at address 0. Then dump the contents of 
program memory, to verify that the memory now contains new data from the PROM. 

> RPR 2564/TI 40 

> D 40 

0123456789ABCDEF 

0000 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E THIS IS A TEST.. 

0010 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E THIS IS A TEST.. 

0020 54 48 49 53 20 49 53 20 41 20 54 45 55 54 2E 2E THIS IS A TEST.. 

0030 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E THIS IS A TEST.. 

0040 54 T 

Let's assume that your 8-bit PROM is to be used as the most significant half of a 16-bit memory 
system. Again, fill program memory with EEs, read the PROM, and dump the results. This time, 
however, include the -M modifier in the RPR command line. 

> F 40 EE 

> RPR -M 2564/TI 40 

> D 40 

0123456789ABCDEF 

0000 54 EE 48 EE 49 EE 53 EE 20 EE 49 EE 53 EE 20 EE T.H.I.S. .I.S. . 

0010 41 EE 20 EE 54 EE 45 EE 53 EE 54 EE 2E EE 2E EE A. .T.E.S.T 

0020 54 EE 48 EE 49 EE 53 EE 20 EE 49 EE 53 EE 20 EE T.H.I.S. .I.S. . 

/-iriTi-i ^T^ 2£ on 2''^ "^4 EE 45 EE 53 EE ""4 EE ''E EE ''E EE \ T E.^.T..... 
0040 54 

The D command display shows that the 8-bit bytes received from the PROM are now stored in 
program memory in the most significant byte positions of 16-bit data words. 
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Now see what happens when the RPR command line includes the -L modifier: 

> F 40 EE 

> RFR -L 2564/TI 40 

> D 40 

0123456789ABCDEF 

0000 EE 54 EE 48 EE 49 EE 53 EE 20 EE 49 EE 53 EE 20 .T.H.I.S. .I.S. 

0010 EE 41 EE 20 EE 54 EE 45 EE 53 EE 54 EE 2E EE 2E .A. .T.E.S.T 

0020 EE 54 EE 48 EE 49 EE 53 EE 20 EE 49 EE 53 EE 20 .T.H.I.S. .I.S. 

0030 EE 41 EE 20 EE 54 EE 45 EE 53 EE 54 EE 2E EE 2E .A. .T.E.S.T 

0040 EE 

Notice that this time, bytes from the PROM are placed in the least significant byte positions of 
16-bit words. 

In the next example, assume that program memory is organized as 16-bit words, but now the 
least significant byte of a word precedes the most significant byte. You want the data in the 
PROM to go into program memory as the most significant byte of each word. Note that -R should 
be used only with either a -L or -M modifier. 

> F 40 EE 



> 


RPR 


-MR 


2564/TI 





40 


> 


D 




40 

' 1 


2 3 4 


5 


6 



789ABCDEF 

0000 EE 54 EE 48 EE 49 EE 53 EE 20 EE 49 EE 53 EE 20 .T.H.I.S. .I.S. 

0010 EE 41 EE 20 EE 54 EE 45 EE 53 EE 54 EE 2E EE 2E .A. .T.E.S.T 

0020 EE 54 EE 48 EE 49 EE 53 EE 20 EE 49 EE 53 EE 20 .T.H.I.S. .I.S. 

0030 EE 41 EE 20 EE 54 EE 45 EE 53 EE 54 EE 2E EE 2E .A. .T.E.S.T.... 
0040 EE 

If you wanted the PROM data in this example to go into the least significant byte of program 
memory, you would have entered "-LR" in the RPR command line. 
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wpr [-a] [-d] 



-m 
-i 



SYNTAX 

[-r] [-n] memlo promtype promlo promhi 



PARAMETERS 



-a 



-m 

-n 
-r 



memlo 
promtype 

promlo 
promhi 



Provides inverted addressing {hi=0, !ow=1). Use -A in applications where the 
levels applied to the PROM's address pins are inverted. 

Data is stored In the PROM In Inverted form (hl=0, low=1). During a write 
(WPR), data in program memory Is Inverted before being written Into PROM. 

For the S-bli PROMs supported by the 2764 Module, this modifier indicates 
that data being written Into the PROM represents the least significant bytes of 
16-bit words in program memory. See also -R. 

For 8-blt PROMs, this modifier indicates that data being written into the PROM 
represents the most significant bytes of 16-bit words in program memory. See 
also -R. 

Specifies that no erase check Is performed before a write operation. 

When the data in program memory Is arranged In 1 6-bit words, indicates that 
the bytes are arranged In reverse order In program memory; that Is, the least 
significant byte is first, followed by the most significant byte. 

The -R modifier is used with -M or -L. For example, if modifiers -M and -R 
are entered as part of a WPR command when programming an 8-blt PROM, 
the bytes written to the PROM will be taken from the second byte of each 
1 6-bit word in program memory. 

Specifies the starting address from which data is transferred to the PROM. 

The alphanumeric name specifying the PROM with which you are working. To 
determine the PROM type associated with your chip, see Table 80-1 (earlier in 
this section), or use the PTYPE command. The promtype parameter must be 
entered exactly as shown; letters must be uppercase. 

Specifies the PROM address that you wish to be the starting point for the 
specified command. 

Specifies the ending PROM address. 
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EXPLANATION 

The WPR command writes the contents of the specified locations in program memory into the 
specified PROM addresses. The programming routine verifies that each byte is programmed 
correctly. No message is displayed unless an error is detected. A location must be erased before 
it can be progrmmed with new data. 

The Intel 2817 EEPROM (promtype 2817/1) is electrically erasable. If you specify the entire 
EEPROM address space in the WPR command, then the entire chip is automatically erased. 
Otherwise, only those portions of the EEPROM between promlo and promhi are automatically 
erased. To manually erase individual bytes of the 2817, write FF into the appropriate memory 
locations. You must use the -N modifier when programming a 2817/1 type PROM. 

All other PROMs supported by the 2764 Module are EPROMs — that is, they must be erased by 
exposure to ultraviolet light. Before writing to an EPROM, the PROM Programmer checks the 
designated addresses in the PROM to ensure that the device has been erased and is ready to 
accept new information. You may disable this erase check by using the -N command modifier. 

NOTE 

The PROM Programmer has no capability for erasing EPROMS. Erasure must be 
performed by a unit designed for this purpose. 



EXAMPLES 

Assume that you have 51 2 bytes of code for an 8-bit microprocessor in program memory, starting 
at address 00. To program this code into the bottom addresses of an Intel 2764 device, enter the 
following command: 

> WFR 00 2764/1 IFF 

Suppose now that you have the following application. The memory system for your 16-bit micro- 
computer uses inverting buffers for both address and data lines. You want to program 12K words 
of code into your PROMs. Within your development system, the most significant byte of each 
1 6-bit word is located at an even address. 

To burn your code into PROMs, you'll need two PROM devices: one for the most significant byte 
of each word, and one for the least significant byte. First, program the least-significant-byte 
PROM: 

> WPR ^DL 00 27128/1 2FFF 

Now, program the most-significant-byte PROM: 

> WPR ^DM 00 27128/1 2FFF 

Notice that in both examples, memlo was specified as 00. When programming 1 6-bit data into 
8-bit PROMs, you only need to specify the starting address of the 16-bit word. The -M and -L 
modifiers automatically take care of any byte displacements. 
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Sometimes you may discover an error in your code after you have burned it into a PROM. If 
you're using an electrically-erasable device, such an error would be easy to correct. But if you're 
using an EPROM, it may take 30 minutes or longer to erase and rsprogram the device; such 
delays are annoying when you're working under tight schedules. In many cases, though, these 
delays can be elim!nated= 

Suppose you read the contents of your recently-programmed PROM back into program memory, 
and see the following dump: 

> RPR 00 2764/1 00 10 

> D 10 

0123456789ABCDEF 

0000 54 48 4D 53 20 49 53 20 49 20 54 45 53 54 2E 2E THMS IS A TEST.. 
OOiO 54 T 

At first glance, it appears that you'll have to erase and reprogram the PROM. However, a little 
more thought reveals a quick solution. 

Let's look at the binary representation of the ASCII characters "M" and "I". They differ only by 
one bit: 

M = 0100 1101 

1 = 0100 1001 

Although you can't change any bit in an EPROM from a to a 1 without erasing the entire device, 
you can change a 1 to a 0. In this case, changing a 1 to a can turn the "M" (at address 02) into 

__ Bin. 

an I : 

> F 02 49 

> WPR -N 00 2764/1 10 

Notice that the -N modifier is used to inhibit the erase check of the device. 

Obviously, not all errors in a PROM's data can be corrected using this procedure, but the tech- 
nique may be useful when a small error is detected. 
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ERROR MESSAGES 

PROM Programmer error messages are identified by tlie keywords "PP ERROR." They are 
divided into two categories: execution errors and power-up errors. 

Execution errors may appear in response to a PROIVI Programmer command (CPR, PSTAT, 
PTYPE, RPR, or WPR) during normal operation. They indicate that the PROM Programmer is 
unable to execute the command. This condition may be easily fixed (by turning on PROM Pro- 
grammer power, for example), or it may require a call to your Tektronix service representative. 

Power-up errors describe problems discovered by the PROM Programmer self-test procedure, 
executed automatically during power up. 

If you see an error message without the words "PP ERROR," refer to the section on Error 
Messages in your System Users Manual. 



Execution Errors 

The following error messages may be received in response to a PROM Programmer command 
(CPR, PSTAT, PTYPE, RPR, or WPR). Some errors are detected by the PROM Programmer, and 
are reported by the operating system. Other errors are detected by the operating system directly. 



Errors Detected by the PROM Programmer 

PP ERROR — CHAR MOD ABSENT, There is no PROM Programmer module inserted in the front 
panel of the PROM Programmer. 

PP ERROR— CONFIG MEM CKSUM. The PROM Programmer module ROM is defective. Contact 
your Tektronix field service representative. Since the PROM Programmer Controller is not mal- 
functioning, try using a different PROM Programmer module. 

PP ERROR— DEV NOT ERASED. A WPR (whte) command was attempted, but the PROM is not 
erased for correct programming. See the discussion of the WPR command elsewhere in this 
section for more information. 

PP ERROR — DEV NOT REPROG. An attempt was made to write to a device, and the results in 
the PROM do not match program memory. This may indicate a bad component, or an attempt to 
use the -N modifier with the WPR command on an unerased section of device memory. See the 
discussion of the WPR command elsewhere in this section for more information. 

PP ERROR — POWER FAIL. The operation was aborted due to an internal power failure. Try the 
operation again. If the POWER FAIL message persists, contact your Tektronix field service 
representative. 

PP ERROR— PROM POWER OFF. The power switch on the PROM Programmer front panel 
assembly must be turned on before PROM Programmer commands can execute. 
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Errors Detected by the Operating System 

Error 80 PROM type not supported. The promtype parameter entered with a CPR, RPR, or 
vVPR command is not recognized by this PROM Programmer module. For a list of PROMs 
supported and their promtype designations, see Table 8C-1 (earlier in this section) or enter the 
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pie, 2764/i or 2764/INTEL are not accepted for the 2764/1 promtype. 

Error 81 Maximum PROM address exceeded. Either the memlo or memhi parameter you en- 
tered in a CPR, RPR, or WPR command exceeded the specified device's address range. 

Error 82 PROM Programmer PTYPE data error. The data specifying the PROM Programmer 
module's device support was corrupted when transferred from the PROM Programmer to the 
development system's operating system. This error indicates some hardware fault in the PROM 
Programmer. Contact your Tektronix field service representative. 

Error 84 PROM Programmer hardware I/O error. The interface between the development sys- 
tem and the PROM Programmer malfunctioned. If this error persists, contact your Tektronix field 
service representative. 



Power Up Errors 

if, after you power up the PROM Programmer according to the instructions in Section 8 of this 
manual, the READY indicator on the PROM Programmer front panel is not illuminated, or if the 
SELF TEST indicator is illuminated, a power-up error occurred. When this condition exists, the 
PSTAT command will report one of the following errors: 

PP ERROR-- CPU 

PP ERROR-- POWER CONTROL 

PP ERROR-- RAM 

PP ERROR-- ROM 

PP ERROR-- SUPPLY MONITOR 

?F ERROR-- SYST INTERFACE 

These errors are hardware failures in the PROM Programmer Controller. Contact your Tektronix 
field service representative to have the PROM Programmer repaired. 
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INTRODUCTION 

This supplement provides information that enables you to use the 8751 PROM Programmer 
Module. The following topics are discussed: 

• Devices supported by the 8751 PROM Programmer Module. 

• A demonstration run for the 8751 PROM Programmer Module. 

• PROM Programmer commands, as they apply to the 8751 PROM Programmer Module. 

• Error messages. 

This supplement is designed to be inserted into one of the following sections: 

• Section 8 of the 8540 System Users Manual, 

• Section 8 of the 8550 System Users Manual (DOS/50 Version 2), or 

• Section 9 of the 8550 System Users Manual (DOS/50 Version 1). 

Throughout this supplement, the term "your System Users Manual" refers to either the 8550 
System Users Manual or 8540 System Users Manual. The 8751 PROM Programmer Module is 
referred to as simply the "8751 module". 




The 8751 module is static-sensitive. To avoid damage to the module, handle it as little 
as possible in high-static situations. Pick up the module by the body, not by the edge 
connectors. Avoid sliding the module over any surface. 
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DEVICES SUPPORTED 

The 8751 module enables the PROM Programmer to program the Intel 8751 microcomputer. The 
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Other microcomputers, similar to the Intel 8751 , ma^ be available from other manufacturers, if 
you are using such a device, verify that its programming specifications are identical to those of the 
Intel 8751. If the specifications are identical, the PROM Programmer, with the 8751 module 
installed, will properly program the device. 



DEMONSTRATION RUN 

This demonstration run provides you with an introduction to PROM programming, using the 8751 
module. This demonstration may also be used to verify the module's operation. 

The demonstration run consists of three steps. First, you'll load some test data into program 
memory. Then, you'll direct the PROM Programmer to program this test data into the target 
device. Finally, you'll read back the data to verify that it was correctly programmed into the target 
device. 

This demonstration run uses the following conventions: 

1 . Underlined — Underlined characters in a command line must be entered from your system 
terminal. Those characters not underlined are system output. 

2. <CR> — Each command line ends with a carriage return. When a carriage return is to be 
entered, the symbol <CR> is used. 



Creating the Test Data 

The test data for this demonstration run is in the form of an ASCII string. First, clear part of the 
development system memory by filling it with zeros: 

> -B" AA AAT?!? AA <'^R> 

Now enter the test data, using the following command (omit the -A modifier if you're using 
DOS/50 Version 1): 

>F 00 OOFF -A "TIME FOR COFFEE!" <CR> 
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Using the D (Dump) command, examine the contents of memory and verify that the test data was 
correctly entered: 



> D 00 OOFF <CR> 
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Programming the Target Device 

Plug the 8751 module into the PROM Programmer opening on your development system's front 
panel. Next, raise the 8751 module's ZIP socket handle, and install your target microcomputer 
into the ZIP socket. Align the device so that pin 1 is next to the ZIP socket handle. 




Be careful not to touch the pins of either your target device or the ZIF socket. Damage 
from static discharge may result. 

Now, turn the PROM POWER switch on. The READY indicator on the PROM Programmer front 
panel assembly should now be lit. (If it is not lit, a problem exists in your PROM Programmer 
Controller; contact a Tektronix field service representative.) 

Now you can program the test data into your target device by entering the following programming 
command: 

> WFR 8751/1 00 OOFF <CR> 

Your target device should now contain the test data. 
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Reading Back the Test Data 

Now it's time to verify that the test data was accurately programmed in your target device. First, 
fi!! the development system memory again with zeros: 

> F 00 OOFF 00 <CR> 



Next, enter the following command to read the contents of the microcomputer's PROM into 
memory: 

> RPR 8751/1 00 OOFF <CR> 

Locations 00-FF of memory should now contain your test data again. To find out, enter the 
following command: 

> D 00 OOFF <CR> 
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If this display appears, the PROM in the 8751 microcomputer was programmed correctly, and the 
8751 module is operational. 

If the display does not appear as shown here, either your target device or the 8751 module is 
defective. Try the demonstration again, using a different target device to isolate the problem. If 
the module is defective, contact a Tektronix field service representative. 
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Summary 

This demonstration introduced you to the basic commands necessary to program 8751 micro- 
computers with the 8751 module. The following discussion explains these and other PROM 
Programmer commands in more detail. 

The demonstration run also verified the 8751 module's operation. If you suspect that the module 
may not be operating properly, contact a Tektronix field service representative. 



PROM PROGRAMMER COMMANDS 

Five operating system commands are used with the PROM Programmer: 

• CPR (Compare PROM) compares the contents of the specified PROM addresses with the 
corresponding data in program memory, and displays any differences. 

• RPR (Read PROM) reads the contents of the specified PROM addresses into program 
memory. 

• WPR (Write PROM) writes data from program memory into the PROM. 

• PSTAT (PROM STATUS) displays the current status of the PROM Programmer, including 
any error conditions. 

• PTYPE (PROM TYPE) displays information about the PROM Programmer module currently 
installed in the front panel of the PROM Programmer: what PROMs or devices are supported 
by the module, and what their characteristics are. 

The following syntax descriptions give the syntax and use of each PROM Programmer command 
as it pertains to the 8751 module. The format is the same as that of the Command Dictionary of 
your 8550 or 8540 System Users Manual. 

NOTE 

Syntax for this section conesponds to DOS/50 Version 2 and OS/40. If you are using 
DOS/50 Version 1, all "dash modifiers" (such as -L, -M, etc.) should be 'colon modifi- 
ers" (:L, :M, etc.). The Technical Notes section of the 8550 System Users Manual 
(DOS/50 Version 2) descrit>es the differences between DOS/50 Version 1 and Version 
2 
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cpr [-a] [-d] 



-I 



SYNTAX 



[-r] memlo promtype promlo promhi 



PARAMETERS 

-a Provides inverted addressing (hi=0, low=1). Not used with the 8751 module. 

-d Data is stored in the PROM in inverted form (hi=0, low=1). For a compare opera- 

tion (CPR), this means that the data from the PROM is inverted before being 
compared with program memory. 

-I The data being read from the PROM represents the least significant bytes of 1 6-bit 

words in program memory. Not used with the 8751 module. 

-m The data being read from the PROM represents the most significant bytes of 

16-bit words in program memory. Not used with the 8751 module. 

-r When the data in program memory is arranged in 16-bit words, indicates that the 

bytes are arranged in reverse order in program memory. Not used with the 8751 
module. 

memlo Specifies the starting address to which data is placed after being read from the 

PROM. 

promtype The alphanumeric name specifying the PROM with which you are working. The 
8751 module only supports the promtype 8751/1, specifying the Intel 8751 micro- 
computer. The promtype parameter must be entered exactly as shown; the letter 
I must be uppercase. 

promlo Specifies the PROM address that you want to be the starting point for the CPR 

command. 

promhi Specifies the ending PROM address. 

EXPLANATION 

The CPR command compares the contents of the specified PROM addresses with the contents 
of program memory, starting at the given memory address. The locations of any differences are 
displayed. If the contents match, no message is displayed. 

The CPR command is useful when you want to verify that the data in the PROM is the same as 
the data in a specified region of program memory. 
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CPR 

Compares PROM With Memory 



EXAMPLES 

Enter the following command to read the contents of locations 0-40 of an Intel 8751 's EPROM 
into locations 0-40 of program memory: 

^ RPR 8751/1 40 <CR> 

Now dump program memory to see what's been read: 

> D 40 <CR> 



0000 


54 


48 


49 


53 


20 


49 


53 


20 


41 


20 


54 


45 


53 


54 


2E 


2E 


THIS 


IS 


A 


TEST 


0010 


54 


48 


49 


53 


20 


49 


53 


20 


41 


20 


54 


45 


53 


54 


2E 


2E 


THIS 


IS 


A 


TEST 


0020 


54 


48 


49 


53 


20 


49 


53 


20 


41 


20 


54 


45 


53 


54 


2E 


2E 


THIS 


IS 


A 


TEST 


0030 


54 


48 


49 


53 


20 


49 


53 


20 


41 


20 


54 


45 


53 


54 


2E 


2E 


THIS 


IS 


A 


TEST 


0040 


54 
































T 









If the data was read correctly, a CPR command at this point will not return a message: 

> CPR 8751/1 40 <CR> 

Let's see what happens when an error is detected. Use the P command to patch new data into 
two locations in program memory. 

> P 05 00 <CR> 

> P 07 00 <CR> 



Now compare the contents again: 

> CPR 8751/1 40 < CR > 

*** COMPARE ERROR AT PROM ADDRESS 

*** COMPARE ERROR AT PROM ADDRESS 



00005H 
00007H 



The CPR command identified the discrepancies introduced into locations 5 and 7 of program 
memory. 
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SYNTAX 



pstai 



EXPLANATION 

The PSTAT command displays the current condition of the PROM Programmer. Normally, 
PSTAT will report "no errors". Conditions that prompt an error message include power failure, the 
absence of a PROM Programmer module, or PROM Programmer power off. 

Error messages are discussed later in this section. 

EXAMPLES 

When no errors are present: 

> PSTAT <^CP. > 

... NO PROM PROGRAMMER ERRORS DETECTED . . . 

Reporting an error condition: 

> PSTAT <CR > 

PP ERROR-- POWER FAIL 



8D-8 



8751 PROM Programmer Specifics Users 



PTYPE 

Displays PROM Types 



SYNTAX 



ptype 



EXPLANATION 

The PTYPE command displays information alx)ut devices supported by the 8751 module. The 
display consists of four columns: 

• PROM TYPE: the name that specifies each device supported by the PROM Programmer 
module. Each name is the model number of the primary source manufacturer, followed by a 
slash and one or more letters specifying the manufacturer. The 8751 module supports only 
the Intel 8751 microcomputer. The PROM TYPE is 8751/1. (Note that there are no spaces in 
the PROM TYPE designation.) 

• MAX ADDRESS: the maximum addressable location of the 8751 's internal EPROM. 

• ERASED STATE: the state of the bits (high or low) when the PROM device has been erased. 

• WORD LENGTH: the number of bits per word for each PROM. 



> FTYPE <CR> 

PROM TYPE MAX ADDRESS 
8751/1 OFFFH 

160-1831-00 



EXAMPLES 

ERASED STATE WORD LENGTH 
HI 8 
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rpr[-a][-d]| [" 



SYNTAX 

[-r ] memlo promtype promlo promhi 



PARAMETERS 

-a. Provides inverted addressing (hi=0, low=1). Not used with the 8751 module. 

-d Data is stored in the PROM in inverted form (hi=0, low=1). For a read operation 

(RPR), this means that the data from the PROM is inverted before being stored in 
program mem.ory. 

-I The data being read from the PROM represents the least significant bytes of 1 6-bit 

words in program memory. Not used with the 8751 module. 

-m The data being read from the PROM represents the most significant bytes of 

16-bit words in program memory. Not used with the 8751 module. 

-r When the data in program memory is arranged in 16-bit words, indicates that the 

bytes are arranged in reverse order in program memory. Not used with the 8751 
module. 

memlo Specifies the starting address to which data is placed after being read from the 

PROM. 

promtype The alphanumeric name specifying the PROM with which you are working. The 
8751 module only supports the promtype 8751/1, specifying the Intel 8751 micro- 
computer. The promtype parameter must be entered exactly as shown; the letter 
I must be uppercase. 

promlo Specifies the PROM address that you want to be the starting point for the RPR 

command. 

promhi Specifies the ending PROM address. 
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EXPLANATION 

The RPR command reads the contents of the specified PROM addresses into the specified 
program memory locations. No message is displayed unless an error is detected. 

EXAMPLES 

First, use the F command to fill program memory with the data byte EE. Later, when you examine 
memory, the EEs will make it easy to see that new data was read in. 

> F 40 EE <CR> 

> D 40 <CR> 

0123456789ABCDEF 

0000 EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE 

0010 EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE 

0020 EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE 

0030 EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE 

0040 EE 

Now use the RPR command to read the contents of memory locations 0-40 of an 8751 's EPROM 
into program memory, beginning at address 0. Then dump the contents of program memory, to 
verify that the memory now contains new data from the PROM. 

> RPR 8751/1 40 <CR> 

> D 40 <CR> 

0123456789ABCDEF 
0000 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E 
0010 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E 
0020 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E 
0030 54 48 49 53 20 49 53 20 41 20 54 45 53 54 2E 2E 
0040 54 



THIS 


IS 


A 


TEST.. 


THIS 


IS 


A 


TEST.. 


THIS 


IS 


A 


TEST.. 


THIS 


IS 


A 


TEST.. 


T 
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SYNTAX 



wpr [-a ] [-d ] 



r_«T 



-I 



[-r ] [-n ] memlo promtype promlo promhi 



-a 
-d 



-m 

-n 
-r 

memlo 
promtype 



promlo 
promhi 



PARAMETERS 

Provides inverted addressing (hl=0, low=1). Not used with the 8751 module. 

Data is stored in the PROM In inverted form (hi=0, low=1). 

The data being written to the PROM represents the least significant bytes of 1 6-bit 
words in program memory. Not used with the 8751 module. 

The data being written to the PROM represents the most significant bytes of 
1 6-blt words in program memory. Not used with the 8751 module. 

Specifies that no erase check is performed t)efore a write operation. 

When the data in program memory is arranged in 1 6-blt words, Indicates that the 
bytes are arranged in reverse order In program memory. Not used with the 8751 
module. 

Specifies the starting address from which data Is written to the PROM. 

The alphanumeric name specifying the PROM with which you are working. The 
8751 module only supports the promtype 8751/1, specifying the Intel 8751 micro- 
computer. The promtype parameter must be entered exactly as shown; the letter 
I must be uppercase. 

Specifies the PROM address that you want to be the starting point for the WRP 
command. 

Specifies the ending PROM address. 



EXPLANATION 

The WPR command writes the contents of the specified program memory locations Into the 
specified PROM addresses. The programming routine verifies that each byte is programmed 
correctly. No message is displayed unless an error is detected. 

A location within the 8751 's EPROM must be erased by exposure to ultraviolet light before It can 
be programmed with new data. Before programming the EPROM, the PROM Programmer 
checks the designated addresses in the EPROM to ensure that the device has been erased and is 
ready to accept new information. You may disable this erase check by using the -N command 
modifier. 
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NOTE 

The PROM Programmer has no capability for erasing EPROMs. Erasure must t)e 
performed by a unit designed for this purpose. 

EXAMPLES 

Assume that you have 51 2 bytes of 8751 code in program memory, starting at address 00. To 
program this code into the bottom addresses of an Intel 8751 device, enter the following 
command: 

> WFR 00 8751/1 IFF < CR > 

Suppose now that you have the following design problem. A peripheral output device connected 
to your 8751 microcomputer has logically-inverted inputs. Your program contains a 256-byte data 
table, starting at address 1 00 in program memory, that may be output to this device. The data 
table will also start at location 1 00 within the 8751 . 

Your original design had the microcomputer invert the data before sending it to the peripheral 
device, but this inversion degraded your prototype's performance. The -D modifier in the WPR 
command offers a solution to this problem: each data byte is logically inverted before the byte is 
programmed into a PROM. 

Using the -D modifier In your WPR command line, you can store the data table in inverted form. 
Thus, the microcomputer is relieved of the inversion task, and prototype performance improves to 
an acceptable level. The command looks like this: 

> WFR -D 100 8751/1 100 IFF < CR > 

Sometimes you may discover an error in your code after you have burned it into the 8751 's 
EPROM. Normally, you would spend 30 minutes or longer to erase and reprogram the device; 
such delays are annoying when you're working under tight schedules. In many cases, though, 
these delays can be eliminated. 

Suppose you read the contents of the recently-programmed 8751 EPROM back into program 
memory, and see the following dump: 

> RPR 00 8751/1 00 10 <CR> 

> D 10 <CR> 

0123456789ABCDEF 
0000 54 48 4D 53 20 49 53 20 49 20 54 45 53 54 2E 2E THMS IS A TEST.. 
0010 54 T 

At first glance, it appears that you'll have to erase and reprogram the EPROM. However, a little 
more thought reveals a quick solution. 

Let's look at the binary representation of the ASCII characters "M" and "I". They differ only by 
one bit: 

M = 0100 1101 
I = 0100 1001 
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Although you can't change any bit in an EPROM from a to a 1 without erasing the entire device, 
you can change a 1 to a 0. In this case, changing a 1 to a can turn the "M" (at address 02) into 
an "I": 

> P 02 49 <CR> 



> WPR -N 00 8751/1 10 <CR> 



Notice that the -N modifier is used to inhibit the erase check of the device. Obviously, not all 
errors in the EPROM 's data can be corrected using this procedure, but the technique may be 
useful when a small error is detected. 



ERROR MESSAGES 

PROM Programmer error messages are identified by the keywords "PP ERROR." They are 
divided into two categories: execution errors and power-up errors. 

Execution errors may appear in response to a PROM Programmer command (CPR, PSTAT, 
PTYPE, RPR, or WPR) during normal operation. They indicate that the PROM Programmer is 
unable to execute the command. This condition may be easily fixed (by turning on PROM Pro- 
grammer power, for example), or it may require a call to your Tektronix service representative. 

Power-up errors descritje problems discovered by the PROM Programmer self-test procedure, 
executed automatically during power-up. 

If you see an error message without the words "PP ERROR," refer to the section on Error 
Messages in your System Users Manual. 



Execution Errors 

The following error messages may be received in response to a PROM Programmer command 
(CPR, PSTAT, PTYPE, RPR, or WPR). Some errors are detected by the PROM Programmer, and 
are reported by the operating system. Other errors are detected by the operating system directly. 
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Errors Detected by the PROM Programmer 

PP ERROR— CHAR MOD ABSENT. There is no PROM Programmer module inserted in the front 
panel of the PROM Programmer. 

PP ERROR— CONFIG MEM CKSUM. The PROM Programmer module ROM is defective. Contact 
your Tektronix field service representative. Since the PROM Programmer Controller is not mal- 
functioning, try using a different PROM Programmer module. 

PP ERROR— DEV NOT ERASED. A WPR (write) command was attempted, but the PROM is not 
erased for correct programming. See the discussion of the WPR command elsewhere in this 
section for more information. 

PP ERROR — DEV NOT REPROG. An attempt was made to write to a device, and the results in 
the PROM do not match program memory. This may indicate a bad component, or an attempt to 
use the -N modifier with the WPR command on an unerased section of device memory. See the 
discussion of the WPR command elsewhere in this section for more information. 

PP ERROR — POWER FAIL. The operation was aborted due to an internal power failure. Try the 
operation again. If the POWER FAIL message persists, contact your Tektronix field service 
representative. 

PP ERROR — PROM POWER OFF. The power switch on the PROM Programmer front panel 
assembly must be turned on before PROM Programmer commands can execute. 



Errors Detected by the Operating System 

Error 80 PROM type not supported. The promtype parameter entered with a CPR, RPR, or 
WPR command is not recognized by this PROM Programmer module. Note that the promtype 
name must be entered exactly as shown. For example, 8751/1 or 8751/INTEL are not accepted for 
the 8751/1 promtype. 

Error 81 Maximum PROM address exceeded. Either the memlo or memhl parameter you en- 
tered in a CPR, RPR, or WPR command exceeded the specified device's address range. 

Error 82 PROM Programmer PTYPE data error. The data specifying the PROM Programmer 
module's device support was corrupted when transferred from the PROM Programmer to the 
development system's operating system. This error indicates some hardware fault in the PROM 
Programmer. Contact your Tektronix field service representative. 

Error 84 PROM Programmer hardware I/O error. The interface between the development sys- 
tem and the PROM Programmer malfunctioned. If this error persists, contact your Tektronix field 
service representative. 



8D-15 



Error Messages 8751 PROM Programmer Specifics Users 



Power-Up Errors 

If, after you power up the PROM Programmer according to the instructions in Section 8 of this 
manual, the READY indicator on the PROM Programmer front panel is not illuminated, or if the 
SELF TEST indicator is illuminated, a power-up error has occurred. When this condition exists, 
the PSTAT command will report one of the following errors: 

PP ERROR— CPU 

PP ERROR— POWER CONTROL 

PP ERROR— RAM 

PP ERROR— ROM 

PP ERROR— SUPPLY MONITOR 

PP ERROR— SYST INTERFACE 

These error messages indicate hardware failures in the PROM Programmer Controller. Contact 
your Tektronix field service representative to have the PROM Programmer repaired. 
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Section 9 
TECHNICAL NOTES 

NOTE 1. PRACTICAL LIMITS OF EMULATION 

No available emulator exactly emulates the target microprocessor. Connecting test circuitry to a 
device always has some loading effect on the device you are testing. Engineers have accepted 
this fact with regard to voltmeters, oscilloscopes, and other test instruments. Similarly, when 
you connect a control probe to a prototype circuit, you are adding circuitry that allows you to 
monitor and control the prototype. This added circuitry has an effect, if only a slight one, on the 
performance of the prototype. Here are some considerations to bear in mind when using an 
emulator: 

• Load and Drive Parameters. We have chosen to use LSTTL buffers between the user's 
prototype and the emulating microprocessor. The consequence is that, where most 
microprocessors have MOS-type inputs and outputs, our emulator has LSTTL inputs and 
outputs. The designer of the target system must keep this in mind when dealing with load 
and drive considerations. 

• Noise. Another parameter that is directly affected by emulation is noise. Since the user's 
circuitry is being driven via a cable from the prototype control probe, the signals will 
necessarily be noisier than when the microprocessor is in the circuit. Further, existing 
noise in the prototype circuit may be aggravated by the cable. 

• Timing. Finally, because of propagation delays through cables and buffers, the timing of 
certain signals at the probe plug may differ slightly from those measured at the 
microprocessor itself. 

In all cases, the variations mentioned are within the worst case specifications of the 
microprocessor being emulated. You should remember, though, thatthese variations doexist. If 
you encounter problems under emulation and not with the microprocessor plugged in, or vice 
versa, check your design for possible marginal timing, loading, or noise conditions. 



NOTE 2. COMPARISON OF OS/40 VERSION 1 
WITH DOS/50 VERSION 2 

This Technical Note compares the 8540 operating system {OS/40 Version 1) and the 8550 
operating system (DOS/50 Version 2). The two operating systems are similar except for a few 
commands, functions related to file handling, and RTPA support. 



Commands 

• All 8540 commands except PERMSTR and ROMPATCH are also valid on the 8550. 

• All commands that are shared by the 8540 and the 8550 are identical except for the 
CONFIG command. 
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File Handling Considerations 

The 8540 relies upon its host computertodofile handling tasks, unlikethe 8550, which handles 
its own files. As a result, the 8540 performs differently in the following areas: 

• Conrsnrtand set. The following 8550 commands are not supported by the 8540: 



ACE 

ASM 

ATT 

BR 

CMPF 

CON 



COP 

CREATE 
DAT 
DEL 
DUP 



FD 



I iMk* 



FORMAT 


LIBGEN 


HELP 


MDL 


HOST 


PRINT 


K 


REN 



SYS 

SYS PATCH 

T 

USER 

VERIFY 



• SVCs. All files used by 8540 SVCs must reside on the host (for example, the 8560). All files 
used by 8550 SVCs must reside on the 8550. 

The 8540 does not support SVCs 06, 18, 21, 48-4C, 4E, 58, and 59. 

On the 8540, Overwrite SVCs are implemented as Write SVCs, and l/0-and-Proceed SVCs 

are implemented as l/0-and-Wait SVCs. 

• intersystem Communication. The 8540 cannot be a host computer. 

• Software Installation. On the 8540, software is installed via ROM. On the 8550, software 
is installed via disk. 



Support of TTA, RTPA 

The 8540 supports only the Trigger Trace Analyzer (TTA). The 8550 supports both the TTA and 
the Real-Time Trace Analyzer (RTPA) 



NOTE 3-COMPARISON OF THE TTA AND THE RTPA 

This technical note compares the Trigger Trace Analyzer and the Real-Time Prototype Analyzer. 
Refer to your TTA Users Manual, the Operating Procedures Section of this manual, and the 
Emulation Section of this manual for more information about the TTA. 
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Differences 

a. The TTA can monitor up to 24 address lines. The RTPA can monitor up to 1 6 address 
lines. 

b. The smallest time unit that the TTA can count is 200 ns. The smallest time unit the 
RTPA can count is 1 us. 

c. The TTA's Acquisition Memory can hold 255 operations. The RTPA's Real-Time Trace 
buffer can hold 128 operations. 

d. The TTA has 4 event/counter/trigger sets. The RTPA has 2 event/counter/trigger 
sets. 

e. The event/counter/trigger relationships of the TTA are much more flexible than those 
of the RTPA's. As a result, the TTA's TS command has no counterpart in the RTPA. 

f . Each TTA trigger can key on a range of addresses or data. The RTPA can key on a single 
range but requires both event/counter/triggers to do it. milarities 



Similarities 

a. The following functions are similar on both instruments: tracing, counting, triggers, 
and breakpoints. 

b. Both the TTA and the RTPA can use the following input data: address bus, data bus, 
control lines, and data acquisition probe clips. 

c. The TTA's EVE command performs many of the same functions as the RTPA's EVT 
command. 

d. The TTA's AD, BUS, DATA, and PRO commands are analogous to the parameters A, B, 
D, and T of the RTPA's EVT command. 

e. The TTA's ACQ command performs the functions of the RTPA's RT command and has 
additional features. 

f. The TTA's DISP command is similar to the RTPA's DRT command. 
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Section 10 
ERROR MESSAGES 



This section describes error messages which are 
generated by OS/40 or issued by the 8540 upon request 
from the host. Other Tektronix software products that run 
on the 8560 or 8550 can generate error messages which 
are documented in other manuals. Table 10-1 describes 
the general format of each type of error message, and 
indicates the appropriate reference document. 



NOTE 

Any of these codes may be returned as an SRB status 
code after an SVC. Refer to the Service Calls section 
of this manual for information regarding SRB status 
codes. 



Table 10-1 
Summary of Error Message Types 



Source 


Order 


Case 


Format 


Reference Document 


8540/8550 


numeric, 
hexadecimal 


lower 


CMD: Error nn Message 


8540 or 8550 System Users Manual 
Error Messages section 


8560 


alphabetic 
by command 


lower 


cmd: Message 

cmd: Message-Detail 


8560 System Users Manual 
Message: refer to the generating command 
Detail: see Error Messages section 


A Series Assembler 


numeric 


lower 


*****ERR0R nnn:Message 


8550 Assembler Core Users Manual (A Series) 
nnn = 000-199, Error Messages section 
nnn = 200-255, Assembler Specifics 


A Series Linker 


alphabetic 


upper 


MESSAGE 


8550 Assembler Core Users Manual (A Series) 
The Linker section 


A Series Library 
Generator 


alphabetic 


upper 


MESSAGE 


8550 Assembler Core Users Manual (A Series) 
The Library Generator section 


B Series Assembler 


numeric 


lower 


ASM: nnn (s) Message 
*** ASM: nnn (s) Message 


8550 Assembler Core Users Manual (B Series) 
nnn = 000-199, Error Messages section 
nnn = 200-255, Assembler Specifics 


B Series Linker 


numeric 


lower 


LINK:nnn (s) Message 
***LINK:nnn (s) Message 


8550 Assembler Core Users Manual (B Series) 
Error Messages section 
nnn = 000-099, command processing errors 
nnn = 100-199, errors during link 


B Series Library 
Generator 


numeric 


lower 


LIBGEN:nnn (s) Message 
*** LIBGEN:nnn (s) Message 


8550 Assembler Core Users Manual (B Series) 
nnn = 000-199, Error Messages section 
nnn = 200-255, Assembler Specifics 


8550 DOS/50 Editor 


alphabetic 


upper 


MESSAGE 


8550 Editor Users Manual 
Error Messages section 


ACE 


alphabetic 


upper 


MESSAGE 


8500 Advanced CRT-Oriented Editor Users Manual 


MDU^ 


alphabetic 


lower 


Message 


8550 MDL//V Compiler Users Manual 
Error Messages section 


PROM Programmer 


alphabetic 
by function 
group 


upper 


PP ERROR-MESSAGE 
FATAL PP ERROR— MESSAGE 


PROM Programmer Specifics supplement 
for the characteristic module, 
see the heading, Error Conditions 



(a) 
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02 — itiegal channel number. The c'nannei number used 
was outside the range 0-9. 

03 — I/O channel not open. An i/0 operation has been 
attempted on a channel that has not been assigned to a file 
or device. 

05 — iliegai function for device. An attempt has been made 
to perform an illegal function, such as reading from the line 
printer or writing to the paper tape reader. 

06 — Short or unterminated read. The number of bytes 
read was less than the number of bytes requested, or a 
carriage return was not detected. This is the normal status 
when the last (short) block of a file is read. 

07 — Short or unterminated write. A carriage return was 
not detected in the specified number of characters to be 
written, 

OA — Device not operational. Power to the device is on, but 
for some reason it cannot function properly. For example, 
the line printer may be out of paper. 

OC — Device not ready. The 8540 cannot communicate 
with the device you want to access (for example, the host 
computer). Be sure that the device is powered up and con- 
nected to the 8540. 

OD — Device in use. An attempt has been made to assign a 
non-shareable device on a second channel. Only CONI and 
CONO are shareable. 

10— Error reading disk bit map. An error in reading a disk 
bit map has been detected Host-dependent SVC error. 

1 1 — I/O error or access violation on read An error on 
REM!, CONI, or PPTR has been detected, oryou do not have 
read access to the directory or file on the host. 

12 — I/O error or access violation on write. An error on 
REMO, CONO, or PPTP has been detected, or you do not 
have write access to the directory or file on the host. 

1 3— Command not found. 08/40 does not recognize the 
command name. Be sure that the proper emulator software 
has been installed and selected. 



incorrect length or contain illegal characters. May be host- 
dependent. 

17 — Illegal SVC function code. An SVC code has been 
specified that does not exist or is not available to the user. 

18 — Channel already open. Self-explanatory. 

1 9— Volume or disk not found. A file has been specified on 
a volume that is not mounted on the host. Host-dependent 
SVC error. 



1 B — Checksum error. A checksum error in a load file has 
been detected by the LO or RH command. 

IC — Command area in use. Commands may not be 
executed simultaneously. 

1 D — File not found. An attempt has been made to open a 



or exists in a protected directory. Host-dependent SVC 
error. 

1 E — Invalid parameter. OS/40 does not recognize one of 
the parameters entered in a command line. Check the 
required format and parameters in the Command 
Dictionary. 

1 F — No header on load file. An attempt has been made to 
load a file that is not in load module format. 

20 — invalid input parameter. An invalid input parameter 
has been entered. Refer to the Command Dictionary for the 
correct syntax. 

21 — Invalid output parameter. An invalid output para- 
meter has been entered. Refer to the Command Dictionary 
for the correct syntax. 

22 — No transfer address. This status code is returned 
when you use SVC 1 7 or 57 to load a program that does not 
have a transfer address. 

23 — Command buffer overflow The command line 
entered (or the resulting line after all string and parameter 
substitution) must be less than or equal to 80 characters, 
including the carriage return. 

24— Symbol table full An attempt has been made to load 
more symbols into the symbol table (with COM, SYMLO, or 
ADDS) than allowed. The number of symbols possible is 
about 1000, depending on symbol length. Use REMS to 
remove symbols. 

25 — Data format error. The input data is not in the format 
expected by the command. 

26 — No emulator in system. The emulator hardware is not 
installed, or the emulator software is not SELected. 

27 — Numeric parameter out of range. Either the clock 
count or the number of lines to be printed has been set to a 
value that is outside the range 0-64K. 

28 — System interface error. Serious problems have been 
detected in the host interface. Check your 8560 or host 
cable connections and interface baud rate. If this problem 
continues, contact your Tektronix service representative. 

29— Seek error on file I/O. Host-dependent file error. 
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2A — Parameter required. A command line has been 
entered that requires another parameter. Check the 
required parameters in the Command Dictionary. 

2B — Too many parameters. A command line has been 
entered that contains more parameters than required. 
Check the required format in the Command Dictionary. 

2C — Invalid address parameter. An address parameter 
may contain numbers, register names, symbols, memory 
space designators, don't-care values, and the operators + 
and -. Refer to the Command Dictionary for more 
information regarding valid address expressions. 

2E — System must be idle to SELect. The system must not 
have any active commands or programs. SEL destroys the 
current program debugging status. 

2F — Buffer overflow on HSI operation. This error 
indicates serious hardware or software problems. The 
8540 Installation Guide contains verification procedures. 

30 — Invalid address range. An invalid address range has 
been entered. The high address must be greater than or 
equal to the low address. 

32 — Too many trace ranges. An attempt has been made to 
set a fourthTRA command. OnlythreeTRA commands may 
be active at one time. Check the Command Dictionary for 
correct parameters. 

34 — Command not active. An attempt has been made to 
abort or suspend an inactive command. 

35 — Command not suspended. An attempt has been 
made to continue a command that is executing or that has 
finished executing. 

37 — Invalid hexadecimal string. The commands EX, F, and 
P accept a hexadecimal string. Refer to the Command 
Dictionary for the requirements of a hexadecimal string. 

38 — Missing close quotation mark. A quoted string must 
have opening and closing quotation marks. 

39— No emulator selected. An attempt has been made to 
execute an emulator-specific command before an emulator 
has been selected. 

3A — Bad acknowledge. The valid acknowledgments are 
"0" (ASCII 30H) for ACK and "7" (ASCII 37H) for NAK. 

3B — Transfer aborted. A data transfer between the 8540 
and the host was incomplete, so the transfer was aborted. 
Check cable connections, and power switches and 
connections. If the problem persists, run the system 
verification described in the 8540 Installation Guide 
and/or have a qualified service representative run 
diagnosics on the systems communications hardware as 
described in the 8540 Service Manual. 



3C— Memory write error. Data written to memory could 
not be read back. The memory may be ROM, or there may 
be no RAM for the addresses specified. 

3E — Invalid memory space designator. A memory space 
designator (such as SC:) has been incorrectly entered. 

3F — Illegal use of don't-care expression. A don't-care 
expression has been used where a unique value is 
required. 

40 — Memory space designator illegal in expr. A memory 
space designator has been used in a parameter that does 
not allow memory space designators. For example, in a pair 
of parameters that represent an address range, only the 
first may contain a memory space designator. 

41— Word not filled. The string entered with the F or P 
command did not fill an even number of bytes. 

42 — Invalid use of multiple memory spaces. Multiple 
memory spaces can only be used with the commands listed 
under MEMSP in the Command Dictionary. 

43 — No Trigger Trace Analyzer in system. The TTA 

hardware has not been installed. 

44 — Emulator clock missing. Make sure the prototype 
power switch is on and that the prototype clock is 
functioning correctly. 

45 — Emulator faulted. The emulator is malfunctioning. 
Error code 5F may also occur under this condition. Have a 
qualified service representative check the hardware and 
fuses, and clean the board contacts. Make sure that the 
prototype power switch is on, that the prototype clock is 
functioning properly, that the entered commands are valid, 
and that the instructions being executed are legal. 

46 — Odd word address. An attempt has been made to 
modify an area of memory that does not begin on a word 
boundary. 

47 — Byte not filled. An uneven number of hexadecimal 
digits has been entered in an attempt to modify memory 
with the F or P command. You cannot modify a half byte. 

48 — Port has no carrier signal. No carrier signal has been 
detected at the REMI/REMO port. 

49 — Port parity error. A parity error has been detected at 
the REMI/REMO port. 

4A— Port framing error. A framing error has been detected 
at the REMI/REMO port. That is, the number of start, stop, 
and data bits received was not what was expected. The 
COM -M command can be used to set the desired framing. 

4B — All job streams active. The system is busy. 
Commands cannot be entered until one of the currently 
executing commands is finished. 
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4C — Invalid section name. The section does not exist, or 
the section name contains an illegal character or is too 
long, 

4D— PROM power failure. The power to the PROM 
Programmer has failed. 

52 — Command busy. An attempt was made to enter a 
command again when it was already executing. 

53 — Symbol not found. An attempt has been made to 
access a symbol that does not exist or has been entered 
incorrectly. Valid symbols include register names and any 
program symbols you have placed in the symbol table. Be 
sure to include a leading zero on any hexadecimal number 
that starts with a letter, and on any number that begins 
with an X (don't-care). 

54 — Invalid symbol. An invalid character has been 
detected in a symbol, or the symbol is too long. 

55 — Symbol value not alterable. The symbol to which you 
are attempting to assign a value with the S command is not 
alterable. 

56 — Truncation error. An attempt has been made to assign 
too large a value to a symbol or register, or the hex string 
specified in the F (Fill) command does not evenly fill the 
specified memory area. 

57— Invalid arithmetic operator. The only valid arithmetic 
operators are + and - . 

58 — Invalid term in expression. An invalid character or 
character string has been detected in an expression, 

59 — Overflow in expression. The resulting value of an 
expression (or some intermediate value obtained in 
evaluating it) is too large. Expressions are evaluated using 
32-bit arithmetic. 

5A — Invalid dash modifier. Dash modifiers must be letters 
only. Refer to the Command Dictionary for the dash 
modifiers accepted by each command. 

5C — Too many files open. No more than eight channels to 
files can be simultaneously open by commands and user 
programs. Enter the command A -A to close all channels. 

5D — Bad character in number. The valid digits are 0-9, 
A-F, and the standard suffixes: H (hexadecimal), T 
(decimal), or Q (octal), and Y (binary). 

5F— Emulator halted. The emulator halted while a 
program was executing. Error code 45 (Emulator faulted) 
may also occur under this condition. Make sure that the 
appropriate emulator board is installed andthe instructions 
entered are valid. 



60 — Emulator SVC synchronization error A serious 
emulator software error has been detected. Reboot and 
reselect the emulator. If the problem persists, contact your 

ICISIIUIIIA OCIVIIjC I opi coci iiaii vc 

61 — Disk protected against writing. A disk on the host is 
write-protected. Host-dependent SVC error. 

63 — Disk not formatted. Host-dependent SVC error. 

64 — Disk CRC error. A bad block (parity error) has been 
detected on a disk on the host. Host-dependent SVC error. 

65 — Disk full. There are no blocks available for allocation 
on this host disk, or there are no free files. Host-dependent 
SVC error, 

66 — System synchronization error. The 8540 and the 
host have serious interface problems. Reboot your system 
and try again. Contact your Tektronix service representative 
if problems continue. 

67 — Exclusive access conflict. An attempt has been made 
to open a host file or device that is already being used 



69 — Too many channels open. Serious hardware and/or 
software problems have been detected. Reboot your 
system and try again. Contact your Tektronix service 
representative if problems continue. 

6A — Disk structure corrupt. Serious problems have been 
detected in the file structure of your host's disk. Host- 
dependent SVC error. 

6B— Current user is not file owner. An attempt has been 
made to access a file on the host to which you do not have 
access privileges. Host-dependent SVC error. 

6E — Directory alteration invalid An attempt has been 
made to create, delete, or rename a file on the host in a 
directory to which you do not have write access, or to create 
a duplicate name within a directory. Host-dependent SVC 
error. 

6F— Invalid file linkage attempt. Host dependent SVC 
error. 

70 — File full. The file structure of a volume on the host is 
fuii. Host -dependent SVC error. 

71 — String already exists. Using the PERMSTR command, 
an attempt has been made to store a permanent string in 
EEPROM when a string by that name is already stored. 

74 — Program memory jumpered incorrectly. Using the 
68000 or Z8001, the SELect command cannot set up the 
MAC board properly since program memory has been 
strapped so that addresses do not have a unique location. 
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76— ASCII read to CONI terminated by CTRL-C. CTRL-C 
was typed while OS/40 was performing a read operation. 
The data read is not valid. 

77 — Emulator SVC request outstanding. A prior SVC is 
still in progress. Your current request will be filled when 
the first SVC has finished. 

78 — No more program memory available. An attempt has 
been made to Allocate program memory when there is 
none available. Use DEAL to deallocate memory. 

79 — Program memory address not allocated. In order for 
you to access the specified address range, memory must be 
allocated to it using the AL command. 

7A — Program memory address already allocated. An 

attempt has been made to Allocate an address that has 
already been allocated. 

7B — String not found. OS/40 does not recognize the 
string name entered. Check that you have spelled the name 
correctly. Use the STR -L command to list temporary 
strings and/or the PERMSTR -L command to list 
permanent strings. 

7C — String area full. The capacity of either the temporary 
or the permanent string area has been exceeded. Use the 
STR or the PERMSTR command to delete unused strings. 

7D — System memory parity error. Reboot the system. If 
the problem persists, contact your Tektronix service 
representative. 

7E — Error in command execution. A command has been 
executed that detected errors but continued. 

80 — PROM type not supported. The characteristic 
module currently installed does not support the PROM type 
entered. 

81 — Maximum PROM address exceeded. The address 
given is negative, or exceeds the maximum for the PROM 
type. 

82 — PROM Programmer PTYPE data error. System error. 
The PROM type specified in a RPR, WPR, or CPR command 
is not supported by the characteristic module currently 
installed. 

83 — Modifier required. The command entered needs a 
dash modifier. 

84 — PROM Programmer hardware I/O error. System 
hardware error. Contact your Tektronix service representa- 
tive if the error persists. 



85 — Allocation hardware disabled. Program memory 
allocation hardware error. Contact your Tektronix service 
representative if the problem continues. 

87 — Invalid trigger number. There are four TTA triggers, 
numbered 1-4. 

88 — Signals cannot occur simultaneously. Using either 
the TTA, or a Z8001 /Z8002, 8086, or 68000 emulator, an 
attempt has been made to set an event or breakpoint on bus 
signals that are mutually exclusive (such as a read and a 
write on the same line). 

8A — Invalid event linkage (wraparound). Using CONS, an 
attempt has been made to completely link together all 
events. Thus, no trigger can occur. 

8B — Restart requires gate option. In the COU command, 
the restart option must be used in conjunction with a gate 
option. 

8C — Restart/gate not available on trigger 1 . The trigger 1 
hardware has no prior trigger channel from which to gate. 

8D — No section contains specified address. The ADDS 
command requires that any address you add be contained 
within a previously defined program section. Use the COM 
or SYMLO command to download the section definition 
information into the symbol table from your load file. 

8E — Segmentation trap pending. Either your program or a 
system program has attempted to access memory which is 
invalid according to the Z8000 Memory Management Unit. 
Refer to the Z8001 /Z8002 Emulator Specifics supplement 
for further information. 

8F — User memory declared non-existent. An attempt has 
been made to access memory which was declared non- 
existent with the NOMEM command. Check memory 
declarations with the MEM or NOMEM command. If the 
problem persists after checking your program, check your 
MAC board. 



90 — Invalid arming mode. The -A arming modifier needs 
two programmed breakpoints, but only one is currently 
programmed. This error occurs only when using an 
emulator such as the Z8001/Z8002, 8086, or 68000. 

91 — Invalid initial value for counter. Zero is an invalid 
initial value for decrementing counter modes. 

92 — No such label or scalar. An attempt has been made to 
remove a symbol which is non-existent or is a section 
name. 



(5) 
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93 — invalid symboi specification, in a symboi specifica- 
tion of the form section:label, either the section name istoo 
long, the label name is too long, or the specification 
contains an illegal character. 

94— No prototype control probe attached. An attempt 
was made to change from emulation modeOto mode 1 or 2, 
but the prototype control probe is not connected to the 
emulator and the prototype. This error occurs only when 
using the 8086 emulator. 

95— Prototype not ready. When the emulating micro- 
processor attempted to access prototype memory, the 
prototype held the READY line "not ready" for too many 
wait states. Check the prototype. This error occurs only 
when using the 8086 emulator. The number of wait states 
allowed is jumper-selected. 

96 — Prototype bus hang. The prototype has held the bus 
for an inordinate length of time. This is considered a 
"hung" condition; detection of this condition is jumper- 
selectable. The timeout is on the order of one- half second. 
You may hold the bus for any length of time if the jumper is 
not used. Check the prototype. This error occurs only when 
using the 8086 emulator. 

D4 — Internal parse error. Serious software errors have 
been detected. Contact your Tektronix service representa- 
tive if this problem continues. 



D7 — internal term error. Serious software errors have 
been detected. Contact your Tektronix service representa- 
tive if this problem continues. 

El — Emulator double fault or odd stack pointer. On the 

68000, the emulator has halted during a user job. Possible 
causes are a double address or bus error, or an odd system 
stack pointer. Reset the registers and check the program 
and prototype. 

E2 — Processor registers changed. Following a 68000 
processor halt, the emulator had to reset the PC, SSP, and 
SR registers before all the registers were saved. 

E4 — Emulator system error. Unknown emulator error. 
Reboot and reselect. Contact your Tektronix service 
representative if this problem continues. 

E6 — No MAC board in system. No Memory Allocation 
Controller board has been installed. 

E7 — System error on MAC board. Unknown system error. 
Reboot and reselect. If the problem persists, contact your 
Tektronix service representative. 

FE — Process aborted. This message is returned when the 
A command is used. 

FF — End of file. Returned on a Read SVC if the file was at 
end of file before the read occurred. May be host- 
dependent. 
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96 


1001 0110 


214 


D6 


1101 0110 


23 


17 


0001 0111 


87 


57 


0101 0111 


151 


97 


1001 0111 


215 


D7 


1101 0111 


24 
25 


18 


0001 1000 


88 
89 


58 


0101 1000 


152 
153 


98 


1001 1000 


216 
217 


D8 


1101 1000 


19 


0001 1001 


59 


0101 1001 


99 


1001 1001 


D9 


1101 1001 


26 


1A 


0001 1010 


90 


5A 


0101 1010 


154 


9A 


1001 1010 


218 


DA 


1101 1010 


27 


IB 


0001 1011 


91 


5B 


0101 1011 


155 


98 


1001 1011 


219 


DB 


1101 1011 


28 


1C 


0001 1100 


92 


5C 


0101 1100 


156 


9C 


1001 1100 


220 


DC 


1101 1100 


29 
30 


ID 


0001 1101 


93 
94 


5D 


0101 1101 


157 
158 


9D 


1001 1101 


221 
222 


DD 


1101 1101 


IE 


0001 1110 


5E 


0101 1110 


9E 


1001 1110 


DE 


1101 1110 


31 


IF 


0001 1111 


95 


5F 


0101 1111 


159 


9F 


1001 1111 


223 


DF 


1101 nil 


32 


20 


0010 0000 


96 


60 


0110 0000 


160 


AO 


1010 0000 


224 


EO 


1110 0000 


33 


21 


0010 0001 


97 


61 


0110 0001 


161 


A1 


1010 0001 


225 


El 


1110 0001 


34 
35 


22 


0010 0010 


98 
99 


62 


0110 0010 


162 
163 


A2 


1010 0010 


226 
227 


E2 


1110 0010 


23 


0010 0011 


63 


0110 0011 


A3 


1010 0011 


E3 


1110 001 1 


36 


24 


0010 0100 


100 


64 


0110 0100 


164 


A4 


1010 0100 


228 


E4 


1110 0100 


37 


25 


0010 0101 


101 


65 


0110 0101 


165 


A5 


1010 0101 


229 


E5 


1110 0101 


38 


26 


0010 0110 


102 


66 


0110 0110 


166 


A6 


1010 0110 


230 


E6 


1110 Olio 


39 
40 


27 


0010 0111 


103 
104 


67 


0110 0111 


167 
168 


A7 


1010 0111 


231 
232 


E7 


1110 oil 1 


28 


0010 1000 


68 


0110 1000 


A8 


1010 1000 


E8 


1110 1000 


41 


29 


0010 1001 


105 


69 


0110 1001 


169 


A9 


1010 1001 


233 


E9 


1110 1001 


42 


2A 


0010 1010 


106 


6A 


0110 1010 


170 


AA 


1010 1010 


234 


EA 


1110 1010 


43 


2B 


0010 1011 


107 


68 


0110 1011 


171 


AB 


1010 1011 


235 


EB 


1 no 1011 


44 
45 


2C 


0010 1100 


108 
109 


6C 


0110 1100 


172 
173 


AC 


1010 1100 


236 
237 


EC 


1110 1100 


2D 


0010 1101 


6D 


01 10 1101 


AD 


1010 1101 


ED 


1110 1101 


46 


2E 


0010 1110 


110 


6E 


0110 1110 


174 


AE 


1010 1110 


238 


EE 


1110 1110 


47 


2F 


0010 1111 


111 


6F 


0110 1111 


175 


AF 


1010 1111 


239 


EF 


1110 1111 


48 


30 


0011 0000 


112 


70 


0111 0000 


176 


BO 


1011 0000 


240 


FO 


1 11 1 0000 


49 
50 


31 


0011 0001 


113 
114 


71 


0111 0001 


177 
178 


L B1 


1011 0001 


241 
242 


F1 


11 11 0001 


32 


0011 0010 


72 


0111 0010 


82 


1011 0010 


F2 


nil 0010 


51 


33 


0011 0011 


115 


73 


0111 0011 


179 


B3 


1011 0011 


243 


F3 


nil 0011 


52 


34 


0011 0100 


116 


74 


0111 0100 


180 


84 


1011 0100 


244 


F4 


nil 0100 


53 


35 


0011 0101 


117 


75 


0111 0101 


181 


85 


1011 0101 


245 


F5 


nil 0101 


54 
55 


36 


0011 0110 


118 
119 


76 


0111 0110 


182 
183 


86 


1011 0110 


246 
247 


F6 


1111 0110 


37 


0011 0111 


77 


0111 0111 


87 


1011 0111 


F7 


nil 0111 


56 


38 


0011 1000 


120 


78 


0111 1000 


184 


88 


1011 1000 


248 


F8 


nil 1000 


57 


39 


0011 1001 


121 


79 


01 11 1001 


185 


89 


1011 1001 


249 


F9 


nil 1001 


58 


3A 


0011 1010 


122 


7A 


0111 1010 


186 


BA 


1011 1010 


250 


FA 


nil 1010 


59 
60 


3B 


0011 1011 


123 
124 


78 


0111 1011 


187 
188 


88 


1011 1011 


251 
252 


F8 


nil 1011 


3C 


0011 1100 


7C 


0111 1100 


8C 


1011 1 100 


FC 


nil 11 00 


61 


3D 


0011 1101 


125 


7D 


0111 1101 


189 


BD 


1011 1101 


253 


FD 


nil 1101 


62 


3E 


0011 1110 


126 


7E 


0111 1110 


190 


BE 


1011 1110 


254 


FE 


1111 1110 


63 


3F 


0011 1111 


127 


7F 


0111 1111 


191 


8F 


1011 1111 


255 


FF 


111 1 11 11 
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TEKTRONIX HEXADECIMAL 
FORMAT (TEKHEX) 

Standard Tekhex Format 

Table 11-4 
StanHarH Tfikhflx Data RInrk Format 



Field 


Number of 

ASCI! 
Characters 


Description 


/ 


1 


The slash specifies that the block is in Standard Tekhex format. 


Load 
Address 


4 


The address where the object code is to be loaded (high-byte, low-byte format). 


Byte Count 


2 


Number of data bytes in the data field of the block. 


First 
Checksum 


2 


The sum, mod 256, of the six hex digits of the load address and byte count. 


Data 


2n (2 to 60) 


n data bytes, each represented as two hex digits. Maximum of 30 data bytes. 


Second 
Checksum 


2 


Sum, mod 256, of the 2n hex digits of the data field. 



Here is an example of a Standard Tekhex data block; 



t^--Load address 

+ --First checksum 
i ' + Second checksum 



V V V 

010006070202020202020C 



+ --Data 
Byte count 



--Header 
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Standard Tekhex 



Table 11-5 
Standard Tekhex Termination Block Format 



Table 11-6 
Standard Tekhex Abort Block Format 



Field 


Number of 

ASCII 
Characters 


Description 


/ 


1 


The slash specifies that the 
block is in Standard Tekhex 
format. 


Transfer 
Address 


4 


Starting execution address 
(high-byte, low-byte format) 
of the code transmitted in the 
data blocks. 


Byte 


2 


Always 00 in a termination 
block 


Checksum 


2 


Sum, mod 256, of the six hex 
digits of the transfer address 
and byte count. 



Field 


Number of 

ASCII 
Characters 


Description 


/ 


1 


The stash specifies that the 
block is in Standard Tekhex 
format. 


/ 


1 


Another slash to identify the 
abort block. 


Message 


1 to 69 


A message to be displayed 
when the transfer is aborted. 



Here is an exampleof a StandardTekhextermination block: 



+--Transfer address 
i +--Checksum 



/ 10000001 



I +--Byte count 

+--Header 



Here is an example of a Standard Tekhex abort block: 



Header 




Message 




V V 




','5 CONSECUTIVE FAILURES. 


TRANSMISSION ABORTED 
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Extended Tekhex Format 

Each Extended Tekhex block begins with a six-character 
header fi'^id. 

Extended Tekhex has no specially defined abort block. To 
abort a formatted transfer, use a Standard Tekhex abort 
block 

Table 11-7 
Extended Tekhex Header Field 





Number 


of 






ASCII 






Item 


Characters 


Description 


% 


1 




A percent sign specifies that 
the block is in Extended 
Tekhex format. 


Block 


2 




The number of characters in 


Length 






the block: a two-digit hex 
number. This count does not 
include the leading % or the 








end-of-line. 


Block Type 


1 




6 = data block 



Checksum 



3 = symbol block 

8 = termination block 

A two-digit hex number repre- 
senting the sum, mod 256, of 
the values of all the charac- 
ters in the block, except the 
leading %, the checksum 
digits, and the end-of-line. 
Table 11-8 gives the values 
for all characters that may 
appear in Extended Tekhex 
message blocks. 



Table 11-8 
Character Values for Checksum Computation 



Characters 


Values (Decimal) 


0.9 


0..9 


A..Z 


10.35 


$ 


36 


% 


37 


(period) 


38 


.(underscore) 


39 


a.z 


40. 65 



Table 11-9 
Extended Tekhex Data Block Format 



Field 


Number of 

ASCII 
Characters 


Description 


Header 


G 


Standard header iieru. uiock 
type = 6. 


Load 
Address 


2 to 17 


The address where the object 
code is to be loaded: a 
variable-length number. 


Object 


2n 


n bytes, each represented as 
two hex digits. 



Here is an example of an Extended Tekhex data block: 



+ Block length: 15H = 21 

+ Checksum: 1CH = 28 = 1+5+6+3+1 +0+0+0+2+0+2+. 

' +-- Object code: 6 bytes 

%1561C3100020202020202 

+-- Load address: 100H 

+ Block type: 6 

+ Header character 
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Extended Tekhex 



Table 11-10 
Extended Tekhex Termination Block Format 



Field 


Number of 

ASCII 
Characters 


Description 


Header 


6 


Standard header field. Block 
type = 8. 


Transfer 
Address 


2 to 17 


The address where program 
execution is to begin: a 
variable-length number. 



Table 11-11 
Extended Tekhex Symbol Block Format^ 



Field 


Number of 

ASCII 
characters 


Header 


6 


Section 
Name 


2 to 17 


Section 
Definition 


5 to 35 


Symboi 
Defini- 
tion(s) 


5 to 35 each 



Description 



Standard header field. Block 
type = 3. 



The name of the section that 
contains the symbols defined 
in this block: a variable- 
length symbol. 



This field must be present in 
exactly one symbol block for 
each section. This field may 
be preceded or followed by 
any number of symbol defini- 
tion fields. Table 11-12 gives 
the format for this field. 



Zero or more symboi defini- 
tion fields, as described in 
Table 11-13. 



^ For an example of Extended Tekhex symbol block format, 
refer to Section 4 of this manual, Intersystem 
Communication. 

Here is an example of an Extended Tekhex termination 
block: 



Table 11-12 

Extended Tekhex Symbol Block: 

Section Definition Field 



Item 


Number of 

ASCII 
Characters 


Description 





1 


A zero signals a section 
definition field. 


Base 
Address 


2 to 17 


The starting address of the 
section: a variable-length 
number. 


Length 


2 to 17 


The length of the section: a 
variable-length number, com- 
puted as 1 + (high address - 
base address). 



Table 11-13 

Extended Tekhex Symbol Block: 

Symbol Definition Field 



Item 


Number of 

ASCII 
Characters 


Description 


Type 


1 


A hex digit that indicates the 
global/local designation of 
the symbol, and the type of 
value the symbol represents: 

1 = global address 

2 = global scalar 

3 = global code address 

4 = global data address 

5 = local address 

6 = local scalar 

7 = local code address 

8 = local data address 


Symbol 


2 to 17 


A variable-length symbol. 


Value 


2 to 17 


The value associated with the 
symbol: a variable-length 
number. 



+- 

j 


Block length: 8 








1 
1 


+--- Checksum: 1AH = 26 


= 0+8 


H8+2 


f8+0 


7o0881A280 










+ — Transfer address: 


80H 








+ Block type: 8 








+-- 


Header character 
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MOTOROLA LOAD MODULE 
FORMAT 



General Format 



Start of 
Record 


Type of 
Record 


Byte 
Count 


Address 


Data 


Checksum 



Table 11-14 
Motorola Load Module Format 



Name 



No. of ASCII 
Characters 



Content Description 



Start of Record 



1 



Always an 'S'. 



Type of Record 



= header record 

1 = data record 

S = end of file record 



Byte Count 



A two-digit hexadecimal number representing the 
number of data bytes m the block plus three 



Address 



Four hexadecimal digits representing the address 
of the memory location where this record is stored 



Data 



2*N 



N data bytes, each represented as two hexadecimal 
digits 



Cliecksum 



Two-digit hexadecimal number representing the 
one's complement of the sum,, modulo 100H, of the 
data bytes address and byte count 
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Motorola Load Module Format 



Example 



S 1 F 4 09 00 01 00 05 00 00 OE 00 00 OF lA 6A 



Data 



Checksum ■ 



■Address 



Byte Count 

Type of Record 



Start of Record 



Type of Record 1. Specifies the data record. 

Byte Count OF indicates that there are OF pairs of hexadecimal digits in the block following 
the byte count. 

Address 0040. Specifies that the first data byte (09) is stored at address 0040 The next bytes 
(00,01,00,...) are stored at the next contiguous memory locations (0041, 0042, etc.). 

Data Bytes. Pairs of hexadecimal digits representing data bytes stored on the record 

Checksum 6A. The one's complement of the number 95, the sum of the data bytes, address, 
and byte count: 

0F+00+40+09+00+01+00+05+00+00+0E+00+00+0F+1A ^ 95H 



ra 
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General Format 



NTEL LOAD MODULE FORMAT 



Header 
Character 


Record 
Length 


Starting 
Address 


Type of 
Record 


Data 


Checksum 



Table 11-15 
Intel Load Module Format 



Name 



No. of ASCII 
Characters 



Content Description 



Header Character 



1 



Aiways a colon. 



Record Length 



Two-digit hexadecimal value representing the 
number of data bytes. A record length of indicates 
the last record of a file 



Starting Address 



Four hexadecimal digits representing the program 
memory address of the first data byte in the record. 



Type of Record 



00 = normal data record. 

01 = last record of a file. 



Data 



2*N 



Checksum 



N data bytes, each represented as two hexadecimal 
digits. 



Two-digit hexadecimal number representing the 

i two's complement of the sum,, modulo 100H, of the 

i 

1 preceding data bytes, record type, address, ar^d 

i record length. 
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Intel Load Module Format 



Example 




Header 



Record Length 09. Indicates that there are nine data bytes in the record. 

Starting Address 0004. Specifies that the first data byte (01) is stored at program memory 
address 0004. The next bytes (00,00,05...) are stored at the next contiguous memory 
locations (0005, 0006, etc.). 

Type of Record 00. Indicates a normal data record. 



Data Bytes. Pairs of hexadecimal digits representing data bytes stored on the record. 

Checksum 2A. The two's complement of D6, the sum of the data bytes, record type, address, 
and record length. 

09+00+04+00+01 +00+00+05+06+00+00+AE+0F = D6 
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GLOSSARY 



Acquisition Memory. The buffer in the TTA that holds the 
255 bus transactions most recently captured during 
program execution. This buffer stores up to 62 bits of 
information from each bus transaction. 

Address. A number or symbol that specifies a byte in 
memory. 

Assembler. A host system program that translates 
assembly language programs into machine language. 

Assembly Language. A microprocessor-specific pro- 
gramming language that allows the symbolic representa- 
tion of any microprocessor operation. Each operation is 
coded as one assembly language statement. 

Assign. To associate a channel with a device or host file. 

Break. A suspension of program execution by OS/40, 
accompanied by a display of the status of the emulator. A 
break may be set using an OS/40 BK command or one of 
several TTA commands. A break may also result from a 
special action, such as attempting to write to protected 
memory or typing CTRL-C. 

Breakpoint. A program instruction at which a break is set. 
You can set breakpoints by using the TTA or the OS/40 BK 
(Breakpoint) command. The TRA -S command causes a 
break to occur each time a trace line is displayed. 



Buffer. An area of memory where a block of data 
stored. 



may be 



Bus Operation. A transfer of information between a 
microprocessor and a memory or I/O device. The four basic 
types of bus operations are memory read, memory write, 
I/O read, and I/O write. Some emulators recognize other 
types of bus operations. 

Channel. The logical link between a device or host file and 
the operating system. Channels are numbered 0-9. 
Channels 0-7 are user-defined; channels 8 and 9 are 
assigned to standard input and standard output, respec- 
tively. The AS (Assign) command assigns a channel for use 
by a device or host file. 

Characteristic Module. A circuit card that configures the 
PROM Programmer for a particular set of PROM devices. 



Checksum. A value obtained by summing together data 
bytes as they are received. If the checksum calculated by 
the receiving device differs from the checksum transmitted 
with the data, the data may have been transferred 
incorrectly. 

COM Interface. A communications interface between an 
8540 and a host computer, established via the OS/40 COM 
command. Object code can be transferred between the 
host and the 8540, and host commands are executed from 
the 8540 system terminal as if the 8540 were not present. 

Close. To disassociate a channel from a device or host file. 

Control Character. A character whose ASCII code is in the 
range 00 to IF hexadecimal. RUBOUT (ASCII code 7F) is 
also a control character. Some control characters are 
entered using special keys, such as TAB or RETURN. 
Others are entered by pressing the CTRL key and some 
other key at the same time. 

Counter. See General Purpose Counter 

Device. An instrument attached to the 8540 that is used for 
I/O. See the Learning Guide section of this manual for a 
table of standard device names used by OS/40. 

Disassemble. To translate machine language back into 
assembly language mnemonics. The Dl command performs 
disassembly. 

Download. To transfer data from a host to the 8540. 

Editor. A host system program that allows you to create 
and modify text files conveniently. 

EEPROM. Electronically erasable PROMs. EEPROMS on 
the 8540 contain user-defined strings saved with the 
PERMSTR command, and system patch information 
created by the ROMPATCH command. 



Emulating Microprocessor The microprocessor on which 
your program executes during emulation. The emulating 
microprocessor resides on the emulator board or in the 
prototype control probe, and is usually the same type of 
microprocessor as the one being emulated. 
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Emulation. Performing the functions of a microprocessor, 
at or near the microprocessor's execution speed, with 
controllable hardware that facilitates debugging and 
iesiing of the inicroptucessor software in the prototype 
hardware. Emulation features of the 8540 include 
breakpoints, tracing, and event timing. 

Emulation Mode. An 8540 operating mode in which the 
8540 can provide some of the hardware functions needed 
by the microprocessor-based program. The hardware 
functions that can be provided are memory, a clock, and I/O 
facilities. The three modes are: 

• Mode 0: System mode. Your program uses program 
memory and the emulator clock and uses SVCs for I/O. 
Until the prototype is built and connected to the 
emulator hardware, the program may execute only in 
mode 0. 

• Mode 1 : Partial emulation mode. Your program usesthe 
prototype's clock and may access both program and 
prototype memory: the memory map determines 
whether a particular address refers to program or 
prototype memory. Some emulators may also use SVCs. 

A Mode 2" Full '^nr''^*''^'^ rr\r\Mt:i VrMir r^rr^/^ronr» iio^o t\^r\ 

prototype's memory, clock, and I/O facilities. Some 
emulators may also use SVCs. 

Emulator (or Emulator Processor). A circuit board in the 
8540 that emulates the microprocessor that will drive your 
prototype hardware. You may use the emulation and 
debugging features of the emulator to test the software 
that will run on the prototype and to integrate the software 
and hardware components of the prototype. 

Event. The simultaneous occurrence of one or more 
specified conditions that can be detected by the TTA, An 
event is defined in terms of values on the address bus, data 
bus, and certain other lines connected to the emulating 
microprocessor or prototype. 

Expression. A formula that contains numbers, register 
names, or user-defined symbols related by operators. 
Evaluation of the expression yields an integer value. Many 
OS/40 command parameters may be entered as 
expressions. Refer to the Command Dictionary for more 
information on expressions. 

Extended Tekhex. See Tekhex. 

File Pointer. A logical position in a file, maintained by 
OS/40 for use in processing SVCs. All reads from the file 
and writes to the file are performed beginning at the 
current file pointer. The file pointer is updated to the end of 
the data item read or written. The file pointer may also be 
moved using Seek SVCs. An independent file pointer is 
maintained for each channel. 



Filespec. A string of characters that specifies a file on the 
host computer. The term "filespec" in a Command 
Dictionary syntax block may also refer to a standard device 
name such as CONi or REMO. 

Full Emulation Mode See Emulation Mode. 

that increments or decrements while the emulator is 
running. You may use these counters to measure the 
execution time of a program segment, to measure the time 
between two specified events, or to count the occurences 
of an event. 

High-Level Language. A language such as MDL/fj or 
Pascal that reflects algorithms more easily than assembly 
language. A program written in a high level language is 
essentially processor independent, relying on a processor- 
specific compiler or interpreter to convert the program into 
object code. 

Host. A separate computer system that is used to prepare 
and maintain programs that are tested and debugged on 
the 8540. 

Instruction. A machine instruction is a sequence of bytes 
that directs a microprocessor to perform an elementary 
operation such as load, store, add, or branch. An assembly 
language instruction is an alphanumeric representation of 
a machine instruction. The assembler translates an 
assembly language instruction into the corresponding 
machine instruction. 

Instruction Fetch. A bus operation during which the first 
byte of the next instruction to be executed appears on the 
data bus. 

Interrupt. A suspension of normal processing to handle a 
special request. In general, when a microprocessor is 
interrupted by a peripheral device, the microprocessor 
finishes the instruction it is executing, then jumps to the 
routine that services the indicated peripheral, and finally 
returns to the stream of instructions it was executing 
before the interrupt occurred. 

Intersystem Communication. A process by which the 
8540 exchanges information with another computer 
system, via cable or phone line. 

K. 1024 bytes (400 hexadecimal). 

Label. A symbol that represents an address, variable, or 
constant in an assembly language program. 

Linker. A host system program that combines object 
modules into a single executable load module. 
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Load Module. A collection of executable object code 
suitable for loading into program memory. A load module 
maybe in binary format, as produced by a linker ortheSAV 
command, or it may be in a hexadecimal format. Refer to 
the Tables section of this manual for information on 
hexadecimal formats recognized by OS/40. 

LOCAL Mode. Stand-alone mode for an 8540, in which 
each command entered is interpreted by the 8540 itself. 
See also TERM Interface. 

MAC See Memory Allocation Controller. 

Machine Language. The binary language of a micro- 
processor. A high-level or assembly language program 
must be translated to machine instructions before the 
microprocessor can execute the program. 

Memory Allocation Controller. A hardware option that 
permits the expanded addressing capabilities of emulators 
such as the Z8001 /Z8002 and 68000 to operate within the 
confines of 8540 program memory. For such emulators, 
you must have the MAC option installed in order to use the 
DEAL (DEALIocate), MEM (MEMory), and NOMEM 
(NOMEMory) commands. 

Memory Map. An internal table maintained by OS/40that 
indicates which portions of memory used by the emulator 
are in program memory and which are in prototype 
memory. The memory map also indicates which parts of 
program memory are protected from write operations 
during program execution. Memory may be mapped in 
blocks as small as 128 bytes. Use the MAP command to 
change or display the memory map. 

Mnemonic. A symbol that represents a machine 
instruction. Usually the symbol is an abbreviation that 
suggests the machine operation to be performed. For 
example, the 8085A mnemonic MOV represents a 
machine instruction that moves a value into a register. 

Module. A program unit that is complete for purposes of 
compiling, assembling, linking, or loading. It may be 
combined with other modules to produce a complete 
program. See also Load Module; Object Code; Source 
Code 

Object Code. Machine language produced by an 
assembler or compiler from source statements. An object 
module contains one or more sections of object code, plus 
special information used by the linker, library generator, or 
LO command. Each time the assembler executes, it 
produces one object module. An object file is a file that 
contains an object module. 

Operand. A number on which an operation is performed. 
The expression X+3 represents an add operation on the 
operands X and 3. The assembly language statement LDA 
NUM1 performs a load operation on the byte addressed by 
the operand NUM1 . 



Operator. A character or sequence of characters that 
represents an operation to be performed on one or more 
operands. The only operators allowed in OS/40 command 
lines are + and -. 

OS/40. The ROM-based Operating System of the 8540 
Integration Unit. 

Partial Emulation Mode See Emulation Mode. 

Patch. To alter a program by changing the executable 
object code rather than the source code. 

Program Clock. A counter in the 8540 that increments 
every 100 milliseconds while the emulator is running. You 
may use the CLOCK command to initialize or display the 
value in the program clock. This value is also accessible 
through the "Read Program Clock" SVC. 

Program Counter. A register that contains the address of 
the next instruction to be executed. 

Program Memory. Memory in the 8540 that is used as a 
substitute for prototype memory in the early stages of 
prototype development (emulation modes and 1). 

Program/Prototype Memory. This term refers either to 
program memory or to prototype memory, depending on 
the current emulation mode and memory map. In mode 0, 
this term always refers to program memory. In mode 2, this 
term always refers to prototype memory. In mode 1, the 
memory map dictates which address ranges are in program 
memory and which are in prototype memory. 

PROM. Programmable Read-Only Memory. Nonvolatile 
read-only memory that is blank when it is manufactured 
and stores whatever information is written to it by a PROM 
Programmer. 

PROM Programmer. An optional device that writes data 
from memory to a PROM chip or reads data from a PROM 
chip into memory. You must have a PROM Programmer in 
order to use the following commands: CPR, RPR, WPR, 
PSTAT, and PTYPE. 

Prototype. The microprocessor-based device that you are 
developing using the 8540. 

Prototype Control Probe. A probe that takes the place of 
the prototype microprocessor and connects the prototype 
to the appropriate emulator hardware in the 8540. 

Prototype Memory. Memory that resides in the prototype 
being developed. 

RAM. Random Access Memory. Memory that may be read 
from or written to. 

Rewind. To position a file pointer to the beginning of a file, 
so that information in the file can be re-processed. See also 
Seek 
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ROM. Read-Oniy Memory: memory that is manufactured 
with predetermined contents and cannot be written to. 

Seek. To position a file pointer to a given location in a file. 
Your program can use Seek SVCs to select any position in 
the file at which to read or write data. See also Rewind. 

Service Call (SVC). A request for OS/40 to perform a 
specified I/O or maintenance function for an executing 
program. System programs use SVCs.. as do most user 
programs that do not rely entirely on prototype I/O. The 
Service Calls section of this manual explains how to set up 
and initiate a service call, and describes each type of 
service call. 

Source Code. Program statements written in high-level or 
assembly language. A source module is a set of 
statements that are compiled or assembled as a unit. A 
source file is a file that contains all or part of a source 
module. 

Stack. A last-in, first-out (LIFO) data structure. Only the 
last item pushed onto the stack is immediately available. 

\A/h£»r* that itom ic r»r\r»r»£ari rvff th^a cta/^l/ tl-i£a itorm cfnrciri 

before it becomes available. Many microprocessor 
applications use a stack in memory for temporary storage 
or for passing parameters between subroutines. 

Stack Pointer. A register that contains the address of the 
top of the stack. 

Standard Input. The file or device from which a command 
takes its input. Defaults to the system terminal unless you 
redirect input by using a -^filespec parameter in the 
command line. 

Standard Output. The file or device to which a command 
directs its output. Defaults to the system terminal unless 
you redirect output by using a >filespec parameter in the 
command line. 

Standard Tekhex. See Tekhex. 

String. A sequence of ASCII characters. OS/40 allows you 

tn acciri'^ sa nsamo tn a ctrion aniH tHoi-i raiar tr^ tKo ctrirtn K\/ 

name in a command line. If a string contains a delimiter 
such as a space, comma, or semicolon, the string should be 
enclosed in single or double quotes. If it contains a dollar 
sign, backslash, or double quote, the string should be 
enclosed in single quotes. 

Permanent strings, created with the OS/40 PERMSTR 
command, are stored in the 8540's EEPROM storage area 
and thus are available whenever the system is powered up 
or restarted. 

SVC See Service Call. 



Symbol. A string of up to 1 6 characters that begins with a 
letter and contains only letters, digits, periods, underscores, 
or dollar signs, in an assembly language program, 
predefined symbols include assembler directives and 
functions, mnemonics, and register names; user-defined 
symbols represent addresses, data items, variables, 
macros sections or modules. 

Symbol Table A table in system memory that contains 
nrnnrgrn s^'mbols and their values. This table is used in 
symbolic debug. Use the SYMLO or COM commands to 
place symbols from a load file in the symbol table. Use the 
ADDS command to create other symbols. 

Symbolic Debug. The use of symbols in place of 
expressions or hexadecimal numbers during debugging. 
You can use symbols as parameters in any OS/40 
command that accepts expressions as parameters. During 
output, each hexadecimal address is replaced with either a 
symbol or an offset relative to the start of a program 
section. Some emulators do not support symbolic debug: 
refer to your Emulator Specifics supplement for this 
information. 

System Memory. Memory in the 8540 that is not 
accessible to the user. Most OS/40 commands execute in 
system memory. 



System Mode. See Emulation Mode. 

System Terminal. The CRT terminal or other RS-232-C- 
compatible I/O device through which you communicate 
with the 8540. Device names for input and output through 
the system terminal are CONI and CONO, respectively. 

Target Processor. The microprocessor that the 8540 is to 
emulate. 

Tekhex. Tektronix Hexadecimal Format: a format for 
representing the contents of a block of memory as an ASCII 
sequence of hexadecimal digits. Checksums in the Tekhex 
format permit verification of Tekhex data transmitted from 
one computer to another. The WH command can be used to 
write memory contents to a file or device in Tekhex format; 
similarly, RH can be used to read Tekhex data from a file or 
device into memory. There are two forms of Tekhex: 
Standard Tekhex and Extended Tekhex. Both forms of 
Tekhex are described in the Intersystem Communication 
section of this manual. 

TERM Interface. A mode of communication between an 
8560 Multi-User Software Development Unit and an 8540. 
A TERM interface allows you to intermix OS/40 commands 
and TNIX commands, execute OS/40 commands from 
TNIX command files, and transmit data between the 8540 
and 8560. 
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TNIX. The operating system of the TEKTRONIX 8560 Multi- 
User Software Development Unit. 

Trace. To monitor the execution of a program by displaying 
the processor status each time a specified type of 
instruction is executed. The TRA command specifies the 
type and/or range of instructions to be displayed. 

Transfer Address. The address of the first machine 
instruction to be executed in a program. 

Trigger Trace Analyzer (TTA). An optional hardware 
device that enhances the 8540's debugging capabilities. 
The TTA allows you to capture and store up to 255 bus 



transactions that precede or follow a selected event in the 
executing program. The TTA includes four general purpose 
counters and four triggers that can break program 
execution, start or stop counters, or signal other 
instruments. 

You must have a TTA installed in your 8540 in order to use 
any of the following commands: ACQ, AD, BRE, BUS, 
CONS, COU, CTR, DATA, DISP, EVE, PRO, QUA, TCLR, TS. 

Upload. To transfer data from the 8540 to a host. 
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A command, 3-8 

abort 

command, 3-8 
SVC, 6-11 

abortable commands, 3-8 

ACIA, 4-23, 4-25 

ACK character, 4-15 

ACQ command, 5-18 

examples, 2-16-2-17 

Acquisition Memory, 5-16-5-17, 12-1 

AD command, 5-18 

add: 

contents of registers, 3-15 

numbers, 3-15 

symbol to symbol table, 3-9 

address expressions, 3-5 

address map: 

allocate memory to, 3-10 
deallocate memory from, 3-25 

ADDS command, 3-9, 5-9 
examples, 2-9 

AL command, 3-10, 5-11 
examples, 2-9 

apostrophe. See Single quote 

arithmetic expression, 3-5 

arrows, input and output redirection, (< >), 3-3 

AS command, 3-12 

ASCII codes (table), 11-1 

ASCII transfer, 4-8, 6-10 

See also Intersystem communication 

asm (8560 command), 1-25 

assembler, 1-25, 12-1 

assign 

channel to device or file, 3-12 
value to register or symbol, 3-51 

B 

backslash (\), 3-4 

BACKSPACE key, 3-7 

baud rate for data transfers, 4-24 

binary-decimal-hexadecimal equivalents, 11-3 

binary transfer, 4-8, 6-10 

See also Intersystem communication 

BK command, 3-13, 5-4 

boldface in syntax blocks, 3-2 

braces (| 1), 3-2 

brackets ([ ]), 3-2 

BRE command, 5-16 

break, 12-1 

breakpoint, 12-1 

clearing, 2-13, 3-14 
displaying, 2-13, 3-13 
setting, 2-12, 3-13, 5-4 
See also BK command 

buffer (for an SVC), 6-4 

BUS command, 5-15 



CALC command, 3-15, 5-9 

capitalization, 1-15 

carriage return, 1-10 

channels. See I/O channels 

characteristic module. Section 8, 12-1 

characters, control, 3-7 

characters, special: 
ACK(O), 4-15 

apostrophe. See Single quote 
arrows (< >), 3-3 
backslash (\), 3-4 
braces ({ !), 3-2 
brackets ([ ]), 3-2 
carriage return (<CR>), 1-10 
dash (-), 3-3 
dollar sign ($), 1-14, 3-5 
double quote ("), 3-5, 6-10 
escape character (\), 3-4 
NAK (7), 4-15 
null, 3-21, 4-4 
periods (...), 3-2 
semicolon (;), 1-13, 3-2 
single quote ('), 3-5, 6-10 
slash (/), 4-1 
See also Control characters 

checksum, 12-1 

CL command, 3-16 

clear breakpoint, 3-14 

CLOCK command, 3-17, 5-5 

close 

channel, 3-16 
SVC, 6-11 

CO command, 3-18 

code address (symbol type), 4-13 

COM command, 3-19, 4-22 
examples, 2-3-2-5 

COM interface, 1-12, 4-2 

COM Interface Package, 1-5 

command strings, 1-13 
STARTUP, 1-9, 1-14 

command line: 

capitalization, 3-2 

format, 3-2 

notational conventions, 3-2 

commands. Section 3 
abortable, 3-8 
affected by MEMSP, 3-39 
dash modifiers, 3-3 
delimiters, 3-3 
memory areas, 3-7 
multiple, 3-4 
names, 3-3 
parameters, 3-3 

reference manuals for other commands, 3-2 
suspendable, 3-8 
syntax notation conventions, 3-2 

CONFIG command, 2-1-2-2, 3-22 

configuring the 8540, 1-1, 3-22, 3-23 
with an 8560, 1-15 

CONI, 1-5 

CONO, 1-5 

CONS command, 5-16 
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continuing execution of suspended command, 3-18 

control characters, 1-10, 3-7, 12-1 
null, 4-4 

conversion tables, 11-^ 

correcting a typing mistake, 1-11 

COU command, 5-16-5-17 

examples, 2-15, 2-17-2-18 

CPR command, Section 8 

<CR>, 1-10 

CTR command 5-15 

CTRL (control) characters. See Control characters 



D 

D command, 3-24 

examples, 1-32, 1-34, 2-19 

dash (-), 3-3 

dash modifiers, 3-3 

data address (symbol type), 4-13 

DATA command, 5-15 

Data Transfer Types table (COM Interface), 4-3 

data transfers. See Intersystem Communication 

DCE, 4-23 

DEAL command, 3-25, b-l2-b-13 

deallocate memory from logical address map, 3-25 

decimal-hexadecimal-binary equivalents, 1 1-3 

deleting: 

permanent strings, 3-43 
temporary strings, 3-4 
text being entered, 1-11 

delimiters, command, 3-3 

demonstration run, 1-17-1-40 

demonstrations of: 

emulation, 1-17-1-40 
SVCs, 6-6-6-8 

designators (memory space), 3-6 

devices. See I/O devices 

Dl command, 3-26 
examples, 2-20 

disassemble object code into mnemonics, 3-26 

DISP command, 2-16, 3-27, 5-18 

display: 

breakpoint conditions, 3-13 
contents of emulator registers, 3-27 
DISP command, 3-27 
executed instructions, 3-62 
memory contents, 3-24, 3-29 
memory map, 3-36 
memory map assignments, 3-35 
strings: 

permanent, 3-43 

temporary, 3-55 
symbolic, 3-59 
system status, 3-55 

dollar sign ($), 1-14, 3-5 

don't-care expressions, 3-6 

DOS/50: 

compared with OS/40, 9-1 
HOST command, 4-4 

double quote ("), 3-5 

download, 3-21, 4-1 

See also Intersystem communication 

DS command, 3-27 

examples, 2-9, 5-5 



DTE, 4-23 

dump memory contents, 3-24 



EEPROM: 

patching, 3-43 

storing permanent strings in, 3-43 

electrical considerations, 1-1 

for prototype control probe. Section 7 

EM command, 2-8, 3-28 

emulating microprocessor, 5-1 

emulation. Section 5 
limits of, 9-1 
mode 0, 5-1 
modes 1 and 2, 5-6-5-7 

emulation modes, 3-28, 5-1, 12-1 

emulator. 5-1 

display registers, 3-27 

read from emulator port, 3-45 

reinitialize, 3-47 

starting, 5-4 

stopping, 5-4 

write to emulator port, 3-65 

emulator processor. See Emulator 

Qi-r»ijlotr»r_cr\oQif jr^ irifnrnr»atir»n Qootinn 1 

escape character: 

CTRL-C, 3-7 

(\). 3-4 
EVE command, 5-15 

examples, 2-14-2-18 

evaluate arithmetic expression, 3-15 

event, 5-13-5-16, 12-2 
consecutive, 5-16 

EX command, 3-29 

examine or alter memory contents, 3-29, 5-5 

execution: 

abort command or program execution, 3-8 

begin program execution, 3-32 

load and execute program, 3-65 

resume execution of suspended command, 3-11 

SVC execution, 3-57 

time execution of program segment, 3-17 

exit (from program), 6-12 

expressions: 

address, 3-5 

arithmetic expression evaluation. 3-15 

don't-care, 3-6 

operators in expressions, 3-6 
Extended Tekhex, 4-11 

sample load module, 1-18 



F command, 3-30 

examples, 2-20, 5-5 

file pointer, 6-1 1 

files: 

assign channel to file, 3-12, 6-1 1 
close channel to file, 3-16, 6-11 
limitations of file handling SVCs, 6-4 
save memory contents in file, 3-52 

fill program/prototype memory with data, 3-30 

formatted transfers, 4-9-4-21 

See also Intersystem communication 
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G command, 2-8, 3-32 

general purpose counter, 5-16-5-17, 12-2 
examples, 2-15, 2-17-2-18 

global symbol, 4-13 

go (begin program execution), 3-32 



K 



keys, special: 

BACKSPACE, 3-7 

CTRL, 1-10, 3-7 

escape (CTRL-C), 3-7 

RETURN (carriage return), 1-10 

RUBOUT, 3-7 



H 

halting program execution, 5-4, 5-7 

handshaking (in formatted data transfers), 4-16 

hardware requirements for host computer, 4-23 

hardware specification, installation, 

configuration, and verification, 1-1 

hexadecimal: 

formats. See Load module 
read, 3-48 
write, 3-64 

hexadecimal-decimal-binary equivalents, 1 1-3 

hexadecimal multiplication, 11-2 

HOST (DOS/50 command), 4-4 
examples, 2-6 

host computer, 1-7 

See also Intersystem communication 



input/output. See I/O 

installation of 8540 hardware and software, 1-1 

instruction, 12-2 

Intel hexadecimal load module format, 11-10 

interface, define host, 3-22 

interrupts, 12-2 

in emulation mode 0, 5-6 

in emulation modes 1 and 2, 5-7 

intersystem communication: 

COM command parameters, 4-22 
communication with an 8002A, 2-7, 4-6 
communication with an 8550, 2-5-2-7, 4-4 
communication with an 8560, 1-11, 2-1-2-2, 4-1 
communication with other host computers, 1-12, 
2-3-2-5, 4-7 

data transfers, 4-25 

establishing communication, 4-25 

exiting from COM, 4-25 
formatted transfers, 4-9-4-21 
hardware requirements, 4-23 
host computer programs: 

convert to Tekhex, 4-18-4-21 

receive Tekhex, 4-17 

transmit Tekhex, 4-16 
protocols for data transfers: 

formatted, 4-15 

unformatted, 4-8 
Types of Data Transfer table, 4-3 
unformatted transfers, 4-7-4-9 



I/O: 



buffer (for an SVC), 6-4 
channels, 6-4, 6-11 

assigning, 2-21 

closing, 2-21 

displaying assignments, 2-20 
devices: 

identification and type codes, 6-13 

jack numbers, 1-8 
log terminal I/O to device, 3-34 
redirection of standard I/O, 3-3-3-4 



jack numbers, 1 -8 



LAS format for SRB, 6-3 

line printer, 1-6 

accessing the line printer in TERM mode, 1-37 

LIST DBG (assembler directive), 1-20 

LO command, 3-34 

load: 

module, 12-3 

Tektronix Hexadecimal Format (Tekhex), 4-9-4-21 
See also Intersystem communication 
program, 3-34, 3-48, 3-65 
symbols into symbol table, 3-61 

LOCAL mode, 1-11,3-22, 12-3 

LOG command, 2-10, 3-34 

logging in to 8560, 1-11 

logging in to other hosts, 1-12 

logical address map: 

allocating memory to, 3-10, 5-7 
deallocating memory from, 3-25 

lowercase. See Capitalization 

LPT, 1-6 



M 

M parameter (of COM and CONFIG commands), 4-22 

MAC. See Memory Allocation Controller 

manuals: 

overview of related user manuals, 1-41, 3-2 
overview of this manual, 1-40 

MAP command, 2-14, 2-20, 3-35 

MEM command, 3-38, 5-13 

memory: 

allocation, 2-9, 3-10, 5-4, 5-9-5-13 

alter contents, 3-29, 3-42 

available to emulator, 3-38, 3-41 

command memory areas, 3-7 

deallocation, 3-25 

display contents, 3-24, 3-29 

display memory map, 3-36 

fill program/prototype memory with data, 3-30 

layout for SVCs, 6-2, 6-3 

memory map, 3-35-3-36, 5-7 

memory spaces, 3-6, 3-39, 5-11 

program memory, 1-5 

changing contents, 5-5 

displaying contents, 5-4-5-6 

reallocating address blocks in a 32K 8540 system, 5-4 
program/prototype memory, 12-3 

copying data between program and prototype memory, 

3-40 
prototype memory, 1 2-3 
read-only memory (ROM), 12-4 

detecting a write to ROM, 5-4, 5-7 
MAP command, 2-20, 3-35 
TTA, 2-15 
save contents, 3-52, 3-64 
search for value or string, 3-53 
system memory, 12-4 
write protection of prototype memory, 3-35 
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Memory Aiiocation Controiier, 5-3 
commands, 5-11-5-13 
memory spaces, 3-6, 3-39, 5-11 

MEMSP command, 3-39 

mode. See Emulation modes 

MODE SELECT switch, 4-24 

modifiers, command (dash), 3-3 

Motorcia hexadecimal load module format 11-4—11-7 

MOV command, 3-40 

multiple commands, 3-4 



program section. See Section 

PROM Programmer, 1-6, Section 8 

protocols. See Intersystem communication 

prototype, 12-3 

hardware considerations, 5-6, Section 7 
I/O, 5-2-5-3 

prototype control probe, 12-3 

timing consiuerations, oection / 

prototype memory. See Memory 

PSTAT command. Section 6 

PTYPE command. Section 8 



NAK character, 4-15 

names 

command, 3-1, 3-3 
register, 3-6 

NOMEM command, 3-41, 5-13 

notational conventions in a command line, 3-2 

null character, 3-21, 4-4 



object code, 1 2-3 

4. ;„ — „,„^^;„r,„ o c 
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optional products compatible with 8540, 1-5 

OS/40, 12-3 

compared with DOS/50, 9-1 

output. See I/O 

overview of related user manuals, 1-41 

overview of this manual, 1-40 

overwrite, 6-1 1 



P command, 3-42 

examples, 2-19, 5-4 

paper tape reader/punch, 1-6 

parameters, 3-3 

patch (alter) memory contents, 3-42 

periods (...) in syntax blocks, 3-2 

peripherals. See I/O devices 

permanent strings, 3-43 

PERMSTR command, 3-43 
examples, 1-14 

plugging in the 8540, 1-8 

PPTP, 1-6 

PPTR, 1-6 

PRO command, 5-15 

proceed (in SVCs), 6-10 

program (user's): 
aborting, 3-8 

breaking, 2-12, 2-14-2-15, 2-18, 3-13, 5-4, 5-16 
executing, 5-4 
executing repeatedly, 5-4 
halting execution, 3-8, 3-56, 5-4, 6-12 
loading, 3-34 
modifying, 2-10-2-12 
monitoring, 5-4 
timing a segment, 2-17, 2-18, 3-17, 5-16-5-17 

program clock, 3-17, 5-5, 12-3 

program memory. See Memory 



Q 

QUA command, 5-15 

QUERY command, 3-44 

quote, double (") and single ('), 3-5 



R 

radix selector letters, 3-5 

RD command, 3-45 

reading: 

from emulator port, 3-45 
hexadecimal code into memory, 3-48 

read-only memory (ROM). See Memory 

redirecting I/O, 3-3-3-4 

registers: 

add contents of, 3-15 
changing contents of, 3-51 
displaying contents of, 5-5 
names, 3-6 

reinitializing emulator, 3-47 

REMI, 1-8 

REMO, 1-8 

REMOTE port status register, 4-25 

remove symbol from symbol table, 3-46 

REMS command, 3-46, 5-9 

RESET command, 3-47 

resident commands, 3-7 

resuming display, 3-6-3-7 

RETURN key (carriage return), 1-10 

rewind, 6-15 

RH command, 3-48 

ROM. See Memory 

ROMPATCH command, 3-49 

RPR command. Section 8 

RUBOUT key, 3-7 



S command, 2-9, 3-51 

SAS format for SRB, 6-2 

SAV command, 2-2, 3-52 

save memory contents: 
in file, 3-52 
in hexadecimal format, 3-64 

SEA command, 3-53 

search memory for value or string, 
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section (of a program), 1-19 
in symbolic debug, 1-33 
in Tekhex symbol blocks, 4-13 

seek (in SVCs), 6-11, 6-15-6-16 

SEL command, 3-54 

select 

emulation mode, 3-28 
target processor, 3-54 

SELF TEST light: 

on 8301 front panel, 1-9 

on PROM Programmer front panel module, 8-2 

semicolon (;), 1-13, 3-2 

SEND (TEKDOS command), 4-6 

service calls. See SVCs 

service request block. See SRB 

set: 

breakpoint, 3-13-3-14 

memory map assignments, 3-35-3-36 

register or symbol to value, 3-51 

single quote ('), 3-5 

special characters. See Characters, special 

special keys. See Keys, special 

SRB, 6-4 

examples, 6-9 
status codes, 6-4 

SRB vector, 6-3 
examples, 6-9 

standard input and output, 12-4 
redirecting, 3-4 

Standard Tekhex, 4-10 

starting up the 8540, 1-8 

STARTUP string, 1-9, 1-14 

STAT command, 2-20, 3-55 

status of SVC, 6-4 

STR command, 3-55 

strings, 1-13, 3-5 
permanent, 3-43 
STARTUP, 1-9, 1-14, 3-23 
temporary, 3-55 

SUSP command, 3-56 

suspendable (abortable) commands, 3-8 

suspending display, 3-6-3-7 

SVC command, 3-57, 6-3, 6-4 
examples, 2-13-2-14 

SVCs, Section 6 

8540 compared with 8550, 9-2 

accessing host files, 6-4 

applications, 6-5-6-6 

breaking on an SVC, 5-6 

demonstration, 6-6-6-9 

I/O instruction, 6-3, Section 7 

LAS memory layout, 6-3 

phasing SVCs out of a program, 5-6 

SAS memory layout, 6-2 

SYMB command, 3-58, 5-9 

symbolic debug, 1-33-1-34, 5-7-5-9 
Tekhex symbol block, 4-13 

symbols, 3-6 
adding, 3-9 
displaying, 3-59 
loading, 3-61 
removing, 3-46 
returning symbolic equivalent of value, 3-58 

SYMD command, 3-59 

SYMLO command, 2-2, 3-61, 5-9 

syntax block, 3-2 



syntax notation conventions, 3-2 
system I/O, 2-20 
system terminal, 1-5 



target processor, 12-4 

selecting the target processor, 3-54, 5-3 

TCLR command, 5-16 

TEKDOS SEND command, 2-7-2-8, 4-6 

Tekhex (Tektronix Hexadecimal Format), 3-21, 

4-9-4-21, 11-4 

conversion program, 4-18-4-21 
receive program, 4-17 
transmit program, 4-16 

Tektronix Hexadecimal Format. See Tekhex 

temporary strings, 3-4-3-5, 3-55 

TERM mode, 1-7, 1-11, 3-22, 4-1 

terminal I/O, logging to device or file, 3-34 

test clips, 5-14 

timing, 5-5 

considerations for prototype control probe. Section 7 
factors that affect timing, 5-5 

timing a program segment: 
using CLOCK, 3-17 
using SVCs, 6-5 
using the TTA, 2-17, 2-18, 5-16-5-17 

TNIX, 1-7 

TRA command, 3-62 

examples, 1-35-1-37, 2-10-2-12 

tracing: 

using the TRA command, 2-10-2-12, 3-62-3-63, 5-4 
using the TTA, 2-16-2-18, 5-18 

transfer, data, 3-21 

transfer address, 12-5 

trigger, 5-13 

Trigger Trace Analyzer. See TTA 

TS command, 3-2 

TTA: 

Acquisition Memory, 5-16-5-17, 12-1 

breakpoints, 5-16 

clearing, 5-16 

commands, 5-19 

compared with RTPA, 9-2 

event, 5-14-5-16 

consecutive, 5-16 
examples of use, 2-14-2-18 
general purpose counters, 5-16-5-17 
information monitored by, 5-14 
trigger, 5-13-5-18 

turning off the 8540, 1-10 

turning on the 8540, 1-8 

type-ahead, 1-13 

U 

underlined characters: 
in examples, 1-10 
in syntax blocks, 3-2 

unformatted transfers, 4-7 

See also Intersystem communication 

UNIX. See TNIX 

upload, 12-5 

See also Intersystem communication 

uppercase. See Capitalization 

user prototype. See Prototype 
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variable-length numbers and symbols, 4-12 
verification of 8540 hardware, 1-1 
virtual memory, 2-9 



X command, 3-65 



zero-insertion-force (ZIF) socket, 8-1 
zeroing out memory, 1-26 



lA/pit (in c:\/rc:\ K.in 

\A/U ,^^r>-.,-.-.'.r-.^ 0_C/1 

WPR command. Section 8 

write 

hexadecimal, 3-64 

protection: 

of program memory, 5-4 

of prototype memory, 3-35, 5-7 

to emulator I/O port, 3-65 

WRT command, 3-65 
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